PeakMojo 服务器

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

特征

与 PeakMojo API 端点完全集成
持有者令牌身份验证
基于资源和工具的 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 镜像：

创建一个新的构建器实例（如果还没有）：
docker buildx create --use
为多个平台构建并推送图像：
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
验证该图像是否适用于指定的平台：
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"
      ]
    }
  }
}

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

PeakMojo Server

Integrations