PeakMojo 服务器

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

特性

• 与 PeakMojo API 端点的完全集成
• Bearer token 身份验证
• 基于资源和工具的 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. Fork 仓库
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