Ripping MCP服务器
](https://www.npmjs.com/package/rippling-mcp-server)   ](https://github.com/bifrost-mcp/rippling-mcp)
开源 模型上下文协议 （MCP）服务器 翻飞 HR/IT/财务平台。将任何AI代理或LLM连接到您的Rippling工作区——查询员工、管理休假请求、查看公司结构等。
特性
- 18工具 跨越6个域：公司、员工、组织、休假、组、活动
- 承载令牌身份验证 -简单的API令牌设置，不需要OAuth舞蹈
- 了解费率限制 --尊重Ripping的速率限制标头
- AI友好错误 --带有可操作修复建议的结构化错误消息
- TypeScript --全型安全，内置
@modelcontextprotocol/sdk
快速开始
1.获得一个撕裂的API代币
首选 翻飞 > 设置 > API令牌 > 创建API令牌。复制令牌。
2.在Claude Desktop中配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"rippling": {
"command": "npx",
"args": ["-y", "rippling-mcp-server"],
"env": {
"RIPPLING_API_TOKEN": "your_api_token_here"
}
}
}
}3.使用它
问克劳德这样的问题：
- “列出工程部门的所有员工”
- “谁有待处理的休假申请？”
- “显示公司组织结构”
- “爱丽丝的PTO余额是多少？”
工具参考
公司
| 工具 | 说明 |
|---|---|
get_company | 获取公司详细信息（姓名、地址、地点） |
list_departments | 列出所有具有层次结构的部门 |
list_work_locations | 列出工作地点和地址 |
员工
| 工具 | 说明 |
|---|---|
list_employees | 列出在职员工（分页） |
get_employee | 按ID获取特定员工 |
list_all_employees | 列出所有员工，包括已终止的员工 |
search_employees | 按姓名、电子邮件、职务或部门搜索 |
组织
| 工具 | 说明 |
|---|---|
list_teams | 列出团队和子团队关系 |
list_levels | 列出职位级别（IC、经理、高管） |
list_custom_fields | 列出自定义字段定义 |
休假管理
| 工具 | 说明 |
|---|---|
get_leave_balances | 获取员工的PTO/病假余额 |
list_leave_requests | 列出休假请求（按状态、日期、请求者筛选） |
process_leave_request | 批准或拒绝待处理的休假申请 |
list_leave_types | 列出为公司配置的所有休假类型 |
群组
| 工具 | 说明 |
|---|---|
list_groups | 列出所有组 |
create_group | 创建一个包含成员的新组 |
update_group | 更新组名或成员 |
delete_group | 删除组 |
活动
| 工具 | 说明 |
|---|---|
get_company_activity | 获取活动事件（招聘、变更、终止） |
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
RIPPLING_API_TOKEN | 是 | - | 您的撕裂API代币 |
RIPPLING_BASE_URL | 没有 | https://api.rippling.com/platform/api | API基本URL |
对于沙盒/测试，设置 RIPPLING_BASE_URL 到 https://sandbox.rippling.com/api/platform/api.
发展
# Install dependencies
npm install
# Run in development mode
RIPPLING_API_TOKEN=your_token npm run dev
# Run tests
npm test
# Build for production
npm run build
# Type check
npm run lint运作原理
此服务器包装 裂土平台API （V1）并通过模型上下文协议公开它。当AI代理调用工具时，服务器：
- 使用Zod模式验证输入
- 向Ripping API发出经过身份验证的请求
- 自动处理速率限制
- 返回结构化JSON响应（或可操作的错误消息）
局限性
- 员工端点为 只读 （撕裂API V1限制）
- API令牌权限决定每个员工返回哪些字段
- 速率限制由Ripping强制执行（通过响应标头进行监控）
- 处理休假请求需要适当的管理员权限
许可证
麻省理工学院
贡献
欢迎发布问题和PR。