nicobailon/pi-mcp-adapter

Pi MCP Adapter は、Pi AI コーディングエージェント用のプラグインです。実際の課題を解決します：MCP（Model Context Protocol）サーバーは、データベース、ブラウザ、API へのアクセスを AI エージェントに提供しますが、各サーバーには冗長なツール定義が付属しており、実際に何の操作も行わないうちに10,000トークン以上を消費します。数台のサーバーを接続すれば、すでにコンテキストウィンドウの半分を消費してしまいます。

このアダプタの工夫は、すべてのサーバーのツールをエージェントのコンテキストにロードするのではなく、1つのプロキシツール（約200トークン） を公開することです。エージェントが実際に特定の機能を必要とするとき、プロキシを呼び出して、必要に応じて適切なツールを検出・実行します。サーバーは遅延ロードされ、ツールを呼び出すまで接続されません。ツールメタデータはキャッシュされるため、ライブ接続なしで検索や説明が可能です。

インストールは1つのコマンドで完了：pi install npm:pi-mcp-adapter。

設定は標準のMCPファイル（プロジェクト用に.mcp.json、ユーザー全体用に~/.config/mcp/mcp.json）に加え、Pi専用のオーバーライドファイルを使用します。/mcpパネルでセットアップが可能で、/mcp setup コマンドでCursor、Claude Code、Codexなどの他のホストからの設定をPiに取り込むこともできます。このアダプタは以下の機能もサポートしています：

• エージェントプラグイン — プラグインパッケージからMCPサーバーをロードし、<plugin>__<server> の形式でプレフィックスを付ける
• Claudeプラグイン — ローカルのプラグインディレクトリからMCPサーバーとスキルを有効化（明示的な信頼境界；プラグインのダウンロードやインストールは一切行わない）
• Piパッケージ — 別の設定ファイルなしに、Piパッケージ内にMCPサーバーを同梱可能
• プログラム的利用 — createMcpAdapter({ config }) を使用して、MCP設定を自ら管理するSDKやサーバー統合に利用可能
• OAuth — 共有モジュール pi-mcp-adapter/oauth を使って、協力する拡張機能がURLバインドされたOAuthトークンを再利用可能
• イベントバス — 拡張機能はバージョン付きチャンネルにサブスクライブし、読み取り専用のサーバー状態スナップショットを受信可能

セキュリティの詳細：アダプタは外部ホストのファイルを書き換えず、それらから静かにコマンドを実行することもありません。プラグインのシンボリックリンクがディレクトリ外に逃げることを拒否し、OAuthフローのシークレット（CSRF状態、PKCE検証子）はフロー内に留まります。サーバーを無効化しても、プロジェクトローカルのオーバーライドに disabled フラグを書き込むだけで、元のソースファイルは変更されません。

なぜ重要か：コンテキストウィンドウのコストなしにMCPエコシステムにアクセスでき、エージェントが必要に応じてツールを発見できるようになります。すべてを事前にロードする必要がなくなります。