PeakMojo Server

PeakMojoサーバー

PeakMojo API と統合するための Python サーバー実装。

特徴

• PeakMojo APIエンドポイントとの完全な統合
• ベアラートークン認証
• PeakMojo機能へのリソースとツールベースのアクセス
• 開発中の模擬応答への自動フォールバック

インストール

構成

サーバーには次の環境変数が必要です。

• PEAKMOJO_API_KEY : 認証用の PeakMojo API キー
• PEAKMOJO_BASE_URL (オプション): PeakMojo API ベース URL (デフォルトはhttps://api.staging.readymojo.com )

コマンドライン引数を使用してこれらを構成することもできます。

利用可能なリソース

サーバーは、次の 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からプルする

オプション2: ローカルで構築する

コンテナの実行

API キーを使用した基本的な使用方法:

クロスプラットフォームパブリッシング

複数のプラットフォーム用の 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 サーバーを構成します。

ソースから実行した例

ソースコードから直接実行する場合:

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く