TalentLMS

@mindstone/mcp-server-talentlms

面向 Model Context Protocol 主机的 TalentLMS MCP 服务。通过标准化的 MCP 接口，在 TalentLMS 中管理用户、课程、群组、分支、类别、选课、报告和测评。

状态

• 版本： 0.4.0 · npm
• 身份验证： API 密钥（TALENTLMS_API_KEY）
• 工具： 28（用户、课程、群组、类别、报告、测评）
• 服务类型： cloud-api
• 机器可读： STATUS.json

要求

• Node.js 20+
• npm

一键安装

点击按钮后，主机将提示你填写：TALENTLMS_API_KEY、TALENTLMS_DOMAIN、TALENTLMS_REQUEST_TIMEOUT。

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-talentlms"
      ],
      "env": {
        "TALENTLMS_API_KEY": "",
        "TALENTLMS_DOMAIN": "",
        "TALENTLMS_REQUEST_TIMEOUT": "30000"
      }
    }
  }
}

快速开始

安装并构建

cd <path-to-repo>/connectors/talentlms
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-talentlms

本地

node dist/index.js

配置

环境变量

• TALENTLMS_API_KEY — TalentLMS API 密钥
• TALENTLMS_DOMAIN — TalentLMS 子域名（例如，acme.talentlms.com 中的 acme）
• TALENTLMS_REQUEST_TIMEOUT — 请求超时时间，单位为毫秒（默认值：30000）
• MCP_HOST_BRIDGE_STATE — 可选的主机桥接状态文件路径，用于凭据管理
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名

主机配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-talentlms"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "TalentLMS": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/talentlms/dist/index.js"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

工具（28）

列出工具时支持分页：TalentLMS 默认每页返回 20 个项目——传入 page_size（最大值为 1000）和 page_number，即可浏览项目较多的租户。

配置

• configure_talentlms — 配置 TalentLMS API 凭据

用户

• list_talentlms_users — 列出用户（分页）
• get_talentlms_user — 根据 ID 或电子邮件获取用户的完整个人资料
• create_talentlms_user — 创建新用户
• update_talentlms_user — 更新现有用户（姓名、电子邮件、登录名、密码、简介、时区、停用日期；仅适用于非特权用户类型）
• set_talentlms_user_status — 激活或停用用户
• get_talentlms_user_courses — 获取用户已选修的所有课程

课程

• list_talentlms_courses — 列出课程（分页）
• get_talentlms_course — 按 ID 获取完整课程详情
• create_talentlms_course — 创建新课程
• get_talentlms_course_users — 获取选修课程的所有用户
• enrol_talentlms_user — 将用户注册到课程
• unenrol_talentlms_user — 将用户从课程中移除
• get_talentlms_course_sso_link — 生成 SSO 链接，以便将用户引导至课程

群组

• list_talentlms_groups — 列出群组（分页）
• get_talentlms_group — 获取群组详情，包括成员和课程
• create_talentlms_group — 创建新群组
• add_course_to_talentlms_group — 将课程分配给群组

分支

• list_talentlms_branches — 列出分支（分页、多租户）

类别

• list_talentlms_categories — 列出课程类别（分页）

报告

• get_talentlms_site_info — 获取站点级统计数据和配置
• get_talentlms_timeline — 获取用户或课程的活动时间线
• get_talentlms_user_progress — 获取用户在课程中的详细进度
• get_talentlms_leaderboard — 游戏化排行榜（按积分为用户排名；从完整用户列表生成，每次分页获取 1000 条，因此不会遗漏任何用户）
• get_talentlms_user_certifications — 获取用户已颁发的证书及其到期日期

测评

• get_talentlms_test_answers — 获取用户对测试/测验的回答
• get_talentlms_survey_answers — 获取用户对问卷的回答
• get_talentlms_ilt_sessions — 获取某个单元的讲师主导培训课程

安全说明

• 不可信内容封装： TalentLMS 中撰写的文本（课程和群组描述、用户名/个人简介/自定义字段、测试和问卷回答等）会封装在 <untrusted-content source="..."> 标签中返回，以便宿主模型将其视为数据而非指令。ID、状态、时间戳和其他元数据会有意保持原样，以确保工具调用链（例如，将 user_id 复制到下一次调用中）正常运行。
• 权限保护： create_talentlms_user 和 update_talentlms_user 仅接受非特权的 Learner/Trainer 用户类型；管理员/SuperAdmin 帐户必须在 TalentLMS UI 中管理。

许可证

FSL-1.1-MIT — 功能源代码许可证 1.1 版，附带未来适用的 MIT 许可证。该软件将于 2030-04-08 转为 MIT 许可证。