PeakMojo 服务器

一个用于与 PeakMojo API 集成的 Python 服务器实现。

特性

• 完全集成 PeakMojo API 端点
• Bearer 令牌认证
• 基于资源和工具访问 PeakMojo 功能
• 开发期间自动回退到模拟响应

安装

pip install mcp-server-peakmojo

配置

服务器需要以下环境变量：

• PEAKMOJO_API_KEY：您的 PeakMojo API 密钥，用于认证
• PEAKMOJO_BASE_URL（可选）：PeakMojo API 基础 URL（默认为 https://api.staging.readymojo.com）

您也可以通过命令行参数配置这些选项：

python -m mcp_server_peakmojo --api-key YOUR_API_KEY --base-url YOUR_BASE_URL

可用资源

服务器提供了对以下 PeakMojo 资源的访问：

• 用户 (peakmojo://users)
• 角色 (peakmojo://personas, peakmojo://personas/tags, peakmojo://personas/search)
• 场景 (peakmojo://scenarios)
• 工作场景 (peakmojo://job_scenarios)
• 工作 (peakmojo://jobs)
• 应用程序 (peakmojo://applications)
• 实践 (peakmojo://practices)
• 技能 (peakmojo://skills)
• 证书 (peakmojo://certificates)

可用工具

服务器提供了以下工具来与 PeakMojo API 交互：

用户管理

• get_peakmojo_users：获取所有用户列表
• get_peakmojo_user：按 ID 获取用户详情
• get_peakmojo_user_stats：获取用户统计数据
• update_peakmojo_user_stats：更新用户统计数据

角色管理

• get_peakmojo_personas：获取角色列表
• get_peakmojo_persona_tags：获取角色标签
• search_peakmojo_personas：搜索角色
• create_peakmojo_persona：创建新角色

场景管理

• get_peakmojo_scenarios：获取场景列表
• create_peakmojo_job_scenario：创建新的工作场景

工作区管理

• get_workspace_personas：获取工作区的角色

工作管理

• get_job：获取工作详情

应用程序管理

• get_application：获取应用程序详情

实践管理

• get_practice_messages：获取实践消息

技能管理

• get_user_skills：获取用户技能

证书管理

• get_certificates：获取证书列表
• get_certificate_skills：获取证书所需的技能
• issue_user_certificate：向用户颁发证书
• add_certificate_skill_courses：向证书技能添加课程

开发

在开发过程中，如果 API 不可访问，服务器将自动回退到每个端点的模拟响应。这允许在不需要实时 API 连接的情况下进行开发和测试。

错误处理

服务器实现了全面的错误处理：

• 无效的 API 密钥会记录警告
• 失败的 API 请求将回退到模拟响应
• 正确捕获并记录 HTTP 错误
• 所有错误都以带有适当错误消息的 JSON 响应形式返回

Docker 支持

先决条件

Docker 镜像为多个平台构建：

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

选项 1：从 Docker Hub 拉取

docker pull buryhuang/mcp-server-peakmojo:latest

选项 2：本地构建

docker build -t mcp-server-peakmojo .

运行容器

使用 API 密钥的基本用法：

docker run \
  -e PEAKMOJO_API_KEY=your_api_key_here \
  -e PEAKMOJO_BASE_URL=https://api.staging.readymojo.com \
  buryhuang/mcp-server-peakmojo:latest

跨平台发布

要为多个平台发布 Docker 镜像：

1. 创建一个新的构建器实例（如果你还没有创建）：

   docker buildx create --use
   

2. 构建并推送多平台镜像：

   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
   

3. 验证指定平台上的镜像是否可用：

   docker buildx imagetools inspect peakmojo/mcp-server-peakmojo:latest
   

与 Claude Desktop 一起使用

在你的 Claude Desktop 设置中配置 MCP 服务器：

{
  "mcpServers": {
    "peakmojo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PEAKMOJO_API_KEY=your_api_key_here",
        "-e",
        "PEAKMOJO_BASE_URL=https://api.staging.readymojo.com",
        "peakmojo/mcp-server-peakmojo:latest"
      ]
    }
  }
}

从源代码运行示例

如果你想直接从源代码运行：

{
  "mcpServers": {
    "peakmojo": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_peakmojo",
        "--api-key",
        "your_api_key_here",
        "--base-url",
        "https://api.staging.readymojo.com"
      ]
    }
  }
}

贡献

1. 分叉仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request