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 ）
打开拉取请求

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

一个 Python 服务器实现，可以与 PeakMojo API 集成，提供对各种资源的访问，例如用户、角色、场景和管理 PeakMojo 功能的工具。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Lodestar MCP Server
kanlanc
-
security
F
license
-
quality
This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
Last updated -
Python
Blender MCP Server
cwahlfeldt
-
security
F
license
-
quality
A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
Last updated -
4
Python
Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
MCP Server for continue.dev
alexsmirnov
A
security
F
license
A
quality
A Python server implementing the Model Context Protocol to provide customizable prompt templates, resources, and tools that enhance LLM interactions in the continue.dev environment.
Last updated -
2
Python

View all related MCP servers

PeakMojo Server