Polyagent MCP

🚀 Polyagent MCP

Claude CodeエージェントをCodex、Gemini CLI、その他のAIコーディングアシスタントに持ち込むMCPサーバーです。既存の.claude/agents/定義を利用し、追加の設定なしで、MCP互換のクライアントが恩恵を受けることができます。

🚀 クイックスタート

このMCPサーバーは、Claude CodeエージェントをCodexやGeminiなどの他のAIコーディングアシスタントで再利用できるようにするためのものです。ゼロコンフィギュレーションで、既存のエージェント定義を活用できます。

✨ 主な機能

存在理由

Claude Codeエージェントを使用しているチームは、CodexやGeminiを使用する同僚が何も移植することなく同じエージェントを再利用できることを望んでいます。Polyagent MCPは、Claude Codeにアクセスできない可能性のあるCodexやGeminiを使用する貢献者に、ゼロコンフィギュレーションでClaude Codeが提供する同じエージェントベースのワークフローを可能にします。Claude Codeを最適化したサブエージェントの設計に相当な考慮が払われているプロジェクトに対して、そのまま使用できる機能として設計されています。

動作原理

このMCPサーバーをCodexやGemini内で実行すると、別々のCLIセッションを介してエージェントが生成されるため、Claude Codeエージェントと同様の動作をします。これにより、以下のような利点が得られます。

• コンテキスト最適化：エージェントは別々のコンテキストで初期化され、重要なもののみを返すため、メインプロセスで使用するコンテキストが少なくて済みます。
• パフォーマンス向上：各エージェントに独自の知識とルールを提供できます。新しいセッションで動作するため、多くの責任を担う単一のAIエージェントに同じ指示を与える場合と比較して、通常はプロンプトの遵守が大幅に向上します（単一責任の原則）。

📦 インストール

uvxを使用したクイックスタート（推奨）

クローンせずにGitHubから直接実行します。

# デフォルトのstdioトランスポート
uvx --from git+https://github.com/execveat/polyagent-mcp polyagent-mcp

# カスタムポートでのHTTPトランスポート
uvx --from git+https://github.com/execveat/polyagent-mcp polyagent-mcp --transport http --port 8000

ローカル開発用のクローンとインストール

開発用にクローンしてインストールします。

git clone https://github.com/execveat/polyagent-mcp.git
cd polyagent-mcp
uv sync

以下のいずれかの方法でローカルで実行します。

# コンソールスクリプトを使用する
uv run polyagent-mcp

# fastmcp CLIを使用する（自動リロードでの開発用）
uv run fastmcp dev polyagent_mcp.server:mcp

📚 ドキュメント

設定

Codex

Codexの設定に、最低15分のタイムアウトを設定して追加します。

[mcp_servers.agents]
command = "uvx"
args = ["--from", "git+https://github.com/execveat/polyagent-mcp", "polyagent-mcp"]
tool_timeout_sec = 900

ローカル開発用（リポジトリをクローンした場合）：

[mcp_servers.agents]
command = "uv"
args = ["--directory", "/path/to/polyagent-mcp", "run", "polyagent-mcp"]
tool_timeout_sec = 900

重要事項：

• tool_timeout_secを900秒以上に設定してください。低いタイムアウト値では、エージェントの呼び出しが早期に失敗します。
• uvxメソッドは、GitHubから自動的にインストールおよび更新します。
• ローカル開発の場合は、/path/to/polyagent-mcpを実際のクローンパスに置き換えてください。

Gemini CLI

settings.jsonに追加します。

{
  "mcpServers": {
    "agents": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/execveat/polyagent-mcp",
        "polyagent-mcp"
      ],
      "timeout": 900000
    }
  }
}

ローカル開発用：

{
  "mcpServers": {
    "agents": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/polyagent-mcp",
        "run",
        "polyagent-mcp"
      ],
      "timeout": 900000
    }
  }
}

重要事項：

• タイムアウトはミリ秒で指定します。900000 = 15分です。
• ローカル開発の場合は、/path/to/polyagent-mcpを実際のクローンパスに置き換えてください。

環境変数

環境変数を使用して設定します（すべてオプション）。

• POLYAGENT_MCP_DIR – エージェントのMarkdownファイルがあるディレクトリ（デフォルト: .claude/agents）
• POLYAGENT_MCP_CONFIG – ランナー/エージェントの設定を上書きするためのオプションのYAML/JSONファイル
• POLYAGENT_MCP_WORKSPACE – エージェント実行の作業ディレクトリ
• POLYAGENT_MCP_TIMEOUT – デフォルトのタイムアウト時間（秒）（デフォルト: 900）
• POLYAGENT_MCP_LOG_LEVEL – Pythonのログレベル（デフォルト: INFO）
• POLYAGENT_MCP_DEBUG – FastMCPのデバッグモードを有効にする

使用方法

設定が完了すると、MCPクライアントは.claude/agents/内のすべてのエージェントを自動的に検出します。

1. 利用可能なエージェントをリストする：resource://agents/manifestを確認するか、クライアントのツールリストを使用します。
2. エージェントの指示を確認する：委任する前にagent://<agent-name>を読みます。
3. エージェントを呼び出す：エージェントの名前を持つツールを呼び出します（例: commit-agent）。

ツール呼び出しの例：

{
  "tool": "commit-agent",
  "arguments": {
    "task": "適切なメッセージで変更をレビューしてコミットする",
    "context": "ログインフローの認証バグを修正しました"
  }
}

オプションのパラメータ：

• runner – 特定のCLI（codex, claude, gemini）を強制的に使用する
• model – ランナー固有のモデルエイリアス
• timeout_seconds – 長時間の操作のためにタイムアウトを延長する

要件

• Python 3.10以上
• codex, claude, またはgemini CLIの少なくとも1つがインストールされている
• エージェント定義がある既存の.claude/agents/ディレクトリ

📄 ライセンス

MIT