Impart MCP

🚀 Impart MCP (エージェントオーケストレーションレイヤー)

impart-mcp は、Model Context Protocol (MCP) に基づくエージェントオーケストレーションサーバーです。「エージェントオーケストレーションレイヤー」として機能し、Claude CodeやCodex CLIなどの高度なエンジニアリング能力を持つ専門エージェントを標準のMCPツールにカプセル化します。これにより、Claude DesktopやCursorなどのホスト環境が統一されたインターフェースを通じて、複雑なタスクを処理できる「スーパーエージェント」を呼び出すことができます。

🚀 クイックスタート

impart-mcp は、高度なエージェントオーケストレーション機能を提供するサーバーです。以下のセクションでは、その主な機能、インストール方法、使用方法などを説明します。

✨ 主な機能

• 多エージェントオーケストレーション：5種類の事前設定された専門家プロンプトとツール権限を持つ専門エージェントが組み込まれています。
• クロスプラットフォーム統合：Claude Desktop、Cursor、Gemini CLIなどのMCP対応環境と完全に互換性があります。
• 非同期タスク処理：時間のかかるタスクのバックグラウンド実行と結果のポーリングをサポートします。
• 混合モデルプロバイダー：Vercel AI SDKを統合し、Claude Code、Codex CLI、Gemini CLIで駆動するエージェントをサポートします。
• 柔軟な設定：JSON設定ファイルを使用して、各エージェントのモデル、オンオフ、パラメーターをカスタマイズできます。

🛠️ 専門エージェント (Agents)

📦 インストール

方法1：npxで直接実行（推奨）

インストールせずに、MCP設定で直接使用できます。

npx impart-mcp@latest

方法2：グローバルインストール

npm install -g impart-mcp
# または
bun add -g impart-mcp

方法3：ソースコードからインストール

前提条件：Bun または Node.js >= 18

git clone <repository-url>
cd impart-mcp
bun install  # または npm install
bun run build  # ビルド生成物

💻 使用例

Cursorへの設定

1. Cursorの設定 -> Features -> MCPを開きます。
2. 新しいMCPサーバーを追加します。
3. Name: impart-mcp
4. Type: command
5. Command: npx impart-mcp@latest（またはグローバルインストール後は impart-mcp を直接使用）

Claude Codeへの設定

claude mcp add コマンドを使用して一括追加します。

claude mcp add impart-mcp -- npx impart-mcp@latest

またはグローバルインストール後は：

claude mcp add impart-mcp -- impart-mcp

📚 詳細ドキュメント

設定の説明

デフォルトでは、すべてのエージェントは組み込みのデフォルト設定で実行でき、追加の設定は必要ありません。

カスタム設定（オプション）

エージェントのモデルまたはオンオフをカスタマイズする場合は、環境変数 AGENT_CONFIG_PATH を使用して設定ファイルのパスを指定できます。

{
  "mcpServers": {
    "impart-mcp": {
      "command": "npx",
      "args": ["impart-mcp@latest"],
      "env": {
        "AGENT_CONFIG_PATH": "/path/to/your/agent-config.json"
      }
    }
  }
}

自動初期化：指定された設定ファイルが存在しない場合、システムは初回実行時にすべてのデフォルト値を含む設定テンプレートを自動生成し、必要に応じて変更できます。

設定ファイルの例 (agent-config.json)：

{
  "advisor": {
    "model": "codex/gpt-5.2",
    "enabled": true
  },
  "researcher": {
    "model": "claude/sonnet",
    "enabled": true
  },
  "frontend-ui-ux-engineer": {
    "model": "gemini/gemini-3-pro-preview",
    "enabled": true
  }
}

📋 APIドキュメント (MCP Tools)

サーバーは以下の核心ツールを提供します。

パラメーターの説明

call_agent / call_agent_async：

• agent：エージェント名の列挙 (advisor | researcher | explore | frontend-ui-ux-engineer | document-writer)
• prompt：タスクの説明
• cwd：作業ディレクトリ（必須）
• context：オプションのコンテキスト情報

👨‍💻 開発の説明

核心ロジックのパス

📄 ライセンス

MIT License