Docebo MCP 服务器端

关键词

模型上下文协议学习平台集成JSON-RPC 服务端Docebo API 集成鉴权代理

使用说明（Markdown 格式）：

  • 项目简介

    • 这是一个基于 MCP 标准的服务器端实现，提供对 Docebo 学习平台 API 的统一访问入口。通过 MCP，LLM 客户端可以读取资源、调用工具、获取并渲染提示模板，服务器端处理会话管理、能力声明以及与 Docebo API 的对接。

  • 主要功能点

    • 资源、工具、提示模板等上下文信息的托管与管理
    • 通过 JSON-RPC 协议响应客户端请求（如读取资源、调用工具、获取 Prompts）
    • 工具（Tools）定义支持路径参数、查询参数、请求体和鉴权要求
    • Prompts（Prompt 模板）注册、渲染与参数校验
    • OAuth 资源服务器/代理支持，方便公开 MCP 客户端接入
    • 支持多种传输方式（如 HTTP/REST，Hono StreamableHTTP 等）

  • 安装步骤

    • 克隆仓库并进入项目目录
    • 安装依赖并构建：npm install && npm run build
    • 根据需要配置环境变量后启动服务器：npm start

  • 服务器配置（MCP 客户端使用信息，配置以 JSON 形式描述，客户端无需代码）

    • server name: docebo-mcp-server
    • 启动命令与参数示例（注释性描述，供客户端配置参考）：
      • name: docebo-mcp-server
      • command: npm start
      • args:
        • PORT=3000
        • API_BASE_URL=https://your-instance.docebosaas.com
        • MCP_SERVER_URL=https://your-server-url.example.com/mcp
        • DOCEBO_CLIENT_ID=若公开客户端则可选
        • DOCEBO_CLIENT_SECRET=若公开客户端则可选
    • 说明：
      • API_BASE_URL 指向 Docebo 的实例入口 API URL
      • MCP_SERVER_URL 为公开可访问的 MCP 端点地址（例如 https://your-server-url/mcp）
      • 若使用公开 MCP 客户端且需要代币代理，请配置 DOCEBO_CLIENT_ID/DOCEBO_CLIENT_SECRET
      • 服务器默认端口为 3000，可通过 PORT 环境变量调整
    • 客户端连接要点
      • Claude Desktop/Claude Code 等客户端在设置远程 MCP 服务器时，需要提供服务端地址和传输方式（如 HTTP），服务器端应公开发现端点，完成 OAuth/鉴权配置后即可使用

  • 基本使用方法

    • 连接并浏览工具
      • 通过 MCP 客户端的工具列表接口获取可用 Tools 的名称、描述、输入结构等信息
    • 调用工具
      • 按工具的名称及参数集合发送调用请求，服务器返回格式化的文本内容，包含 API 响应摘要、分页信息等
    • 获取 Prompts
      • 列出已注册的提示模板，获取单个提示的示例对话内容
    • 发送/接收 Prompts 与 Tools 的上下文
      • 支持基于响应体的 Markdown/JSON 等渲染格式，以及分页、过滤参数
    • 安全与扩展
      • 通过 OAuth 资源服务器实现对受保护端点的访问控制，默认开启 bearer 认证
      • 可以扩展新工具与新提示模板，注册到 toolDefinitionMap / prompts 注册表中

服务器信息

访问项目