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