nicobailon/pi-mcp-adapter

Token-efficient MCP adapter for Pi coding agent

解決する課題

Pi MCP Adapterは、冗長なツール定義によってLLMのコンテキストウィンドウが圧倒されるのを防ぎます。標準的なModel Context Protocol (MCP) のセットアップでは、単一のサーバーが利用可能なツールを説明するためだけに数千トークンを消費することがあり、それらのツールが実際に使用されるかどうかにかかわらずトークンを消費します。このアダプターは、数百もの個別のツール定義を単一のプロキシツールに置き換え、エージェントが必要に応じてツールを検索して呼び出せるようにします。

仕組み

接続されたすべてのMCPサーバーからすべてのツールを直接LLMに登録する代わりに、アダプターは単一の mcp プロキシツールを提供します。エージェントはこのプロキシを使用して特定のツールを検索し、実行します。

主な技術的特徴は以下の通りです：

  • Lazy Loading: ツールが実際に呼び出されるまでサーバーには接続されないため、起動時のオーバーヘッドが削減されます。
  • Configuration Merging: 標準的な .mcp.json ファイルやホスト固有の設定（CursorやClaude Codeのものなど）を含む、複数のソースからの設定を自動的に検出してマージします。
  • Output Guarding: 巨大なツール出力がコンテキストウィンドウを圧迫するのを防ぐため、アダプターはテキスト出力を50 KiBまたは2,000行に制限し、サイズが大きすぎる結果はエージェントが選択的に読み取れるよう一時ファイルに保存します。
  • Lifecycle Management: リソース使用を最適化するために、lazy、eager、keep-alive、lazy-keep-alive を含むさまざまな接続モードをサポートしています。

対象ユーザー

ツールメタデータのためにコンテキストウィンドウを犠牲にすることなく、MCPサーバー（データベース、ブラウザ、API）を統合したい Pi の利用者。

ハイライト

  • コンテキスト効率: ツール定義のオーバーヘッドを数千トークンから約200トークンに削減します。
  • 柔軟な設定: プロジェクトローカルおよびユーザーグローバルの共有MCP設定をサポートします。
  • セキュアなOAuth: 安全なトークン管理のためにOSの資格情報ストアと統合されており、リモート/ヘッドレスOAuthフローをサポートしています。
  • リソース管理: サイズが大きすぎるツールのレスポンスがセッションをクラッシュさせるのを防ぐための「Output Guard」が含まれています。
  • オンデマンドの発見: すべてのツールをプロンプトに事前ロードするのではなく、検索を通じてエージェントがツールを見つけられるようにします。