内容
# WorkRamp MCP 服务器
一个适用于 [WorkRamp](https://www.workramp.com/) 学习管理系统（LMS）API的 [MCP（模型上下文协议）](https://modelcontextprotocol.io/) 服务器。它允许克劳德（Claude）以及其他任何兼容MCP的客户端以纯中文操作您的WorkRamp实例——注册用户、分配学习路径、审核认证以及查询内容目录，而无需通过管理界面或手动编写API调用。
[](https://modelcontextprotocol.io/)
[](https://www.workramp.com/)
[](https://www.python.org/)
[](LICENSE)
> 将“哪些销售代表尚未完成第三季度合规路径？”转化为克劳德直接从WorkRamp拉取的答案。如果它能为您节省一次管理员控制台之旅，**⭐ star 该仓库**。
## 功能
9类30种工具：
- **连接** — 测试API连接性
- **用户和群组** — 列出、创建、更新用户；管理群组
- **指南** — 列出课程、管理分配
- **路径** — 列出学习路径、管理分配
- **内容** — 浏览内容目录、项目文件夹
- **认证** — 列出认证、查看奖励
- **资源和SCORM** — 列出资源和SCORM课程
- **事件** — 列出讲师主导的事件
- **学院** — 外部学习者门户（联系人、培训、收藏、注册）
## 设置
### 1. 克隆和安装
```bash
git clone https://github.com/msdanyg/workramp-mcp.git
cd workramp-mcp
python3 -m venv venv
source venv/bin/activate
pip install -e .
```
### 2. 获取您的API令牌
从WorkRamp管理员控制台（设置 > API）生成令牌。这是一个Bearer令牌，而不是OAuth。
### 3. 为克劳德代码配置
添加到 `~/.mcp.json`：
```json
{
"mcpServers": {
"workramp": {
"command": "/path/to/workramp-mcp/venv/bin/python",
"args": ["-m", "workramp_mcp.server"],
"env": {
"WORKRAMP_API_TOKEN": "your-token-here",
"WORKRAMP_BASE_URL": "https://app.workramp.com",
"WORKRAMP_ACADEMY_ID": ""
}
}
}
}
```
### 4. 为克劳德桌面配置
将相同的条目添加到 `~/Library/Application Support/Claude/claude_desktop_config.json` 下的 `mcpServers`。
## 环境变量
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `WORKRAMP_API_TOKEN` | 是 | WorkRamp管理员控制台的Bearer令牌 |
| `WORKRAMP_BASE_URL` | 否 | 默认值为 `https://app.workramp.com`。对于欧盟账户，请使用 `https://app.eu.workramp.com` |
| `WORKRAMP_ACADEMY_ID` | 否 | 仅在学院（外部学习者）端点时需要 |
## API说明
- **身份验证**：头部的Bearer令牌（无OAuth）
- **速率限制**：每小时3,000次持续请求，每小时13,000次突发请求（429自动重试）
- **分页**：通过 `page`/`per_page` 参数支持列表端点
- **时间戳**：UNIX毫秒和ISO8601混合使用
## 许可证
[MIT](LICENSE) — 使用、fork、修改。
## 免责声明
这是一个独立的、社区建设的集成，**与WorkRamp无关联，不受WorkRamp支持或认可**。“WorkRamp”是其各自所有者的商标。请使用您自己的API凭证，并遵守WorkRamp的API条款。
