🔖

複数の MCP サーバーを 2 ツールに圧縮する Code Mode MCP を作った

に公開

はじめに

Claude Code で複数の MCP サーバー(Notion, Playwright, Chrome DevTools)を使うと、ツール定義だけで 36.6k tokens 消費します。
メタ MCP サーバー「Code Mode」を作り、2 ツールに圧縮することで 4.4k tokens まで削減しました(88% 削減)。
この記事では、アプローチの紹介と実装上のハマりどころを共有します。同様の課題を持つ人への参考になればと思います。

Code Mode のいきさつ

「Code Mode」という名前とアプローチは、Anthropic の記事 Code execution with MCP で紹介されている考え方に基づいています。

LLM に大量のツール定義を渡す代わりに、コードを書いて実行させることで、ツール定義のオーバーヘッドを削減しつつ柔軟な操作が可能になりました。

なお、今回は Notion, Playwright, Chrome DevTools の 3 つを子サーバーとして接続しています。Playwright と Chrome DevTools は機能が重複していますが、いろいろ検証したかったため両方入れています。コンテクスト削減の数値はこれによるところが大きいですが、効果には変わりありません。

MCP のコンテクスト問題

Claude Code で MCP サーバーを使うと便利なのですが、ツール定義が初期コンテクストに含まれます。
( /context で確認できます)

MCP tools: 36.6k tokens (18.3%)
└ mcp__chrome-devtools__click: 636 tokens
└ mcp__chrome-devtools__close_page: 624 tokens
└ mcp__chrome-devtools__drag: 638 tokens
... (26個)
└ mcp__playwright__browser_close: 573 tokens
└ mcp__playwright__browser_click: 753 tokens
... (22個)
└ mcp__notionApi__notion-fetch: ...
... (15個)

Notion で 15 個、Playwright で 22 個、Chrome DevTools で 26 個…。
合計 60 個以上のツール定義が毎回読み込まれます。200k tokens のコンテクストのうち、18% がツール定義で埋まっていました。

Code Mode で解決してみる

「全ツールの使い方(定義)」を教える代わりに、「調べ方」と「実行方法」だけ教えます。

Code Mode MCP (2ツール)
├── search_docs: 子MCPサーバーのAPIドキュメントを検索
└── execute_code: TypeScriptコードで子MCPツールを呼び出し

search_docs

// クエリ省略で全bindings一覧
await search_docs({})
// => notion: { notion-search, notion-fetch, ... }
// => playwright: { browser_click, browser_navigate, ... }
// => chrome: { click, navigate_page, ... }

// 特定の機能を検索
await search_docs({ query: 'navigate' })
// => playwright.browser_navigate の詳細なスキーマが返る

execute_code

Code Mode の中核機能です。渡されたコード内では、子サーバー名(playwright, notion, chrome など)がそのまま使えるようになっています。これは実行時に Code Mode が各サーバーの bindings を注入しているためです。

await execute_code({
  code: `
    // playwright, notion, chrome が使える
    await playwright.browser_navigate({ url: "https://example.com" });
    const snapshot = await playwright.browser_snapshot({});
    console.log(snapshot);
  `,
})

複数の操作を 1 回の呼び出しにまとめられます。

実装のポイント

execute_code の実行環境

execute_code では LLM が生成した任意の TypeScript を実行する必要があります。ただし、何でもできてしまうと危険なのである程度サンドボックス化したい。

この要件を満たすために Deno を選択しました。Worker 内のコードが MCP ツールを呼び出すと、postMessage で親プロセスに依頼し、親プロセスが実際の MCP 呼び出しを行って結果を返します。Worker 自体には外部アクセス権限がないため、MCP ツール経由でのみ外部とやりとりできる仕組みです。

  1. TypeScript をそのまま実行できる: トランスパイル不要で、LLM が生成した TypeScript コードをそのまま実行可能
  2. Worker API がビルトイン: Web Worker ベースのサンドボックス実行が標準で使える
  3. 権限モデルがそのまま使える: Worker に「ネットワーク禁止/ファイルアクセス禁止」を簡潔に適用できる
  4. MCP SDK が対応: @modelcontextprotocol/sdk が Deno で動作する

実行環境の制約

execute_code で実行されるコードには以下の制約があります。

項目 制約
タイムアウト 30 秒
利用可能な API console.log, 基本的な JS/TS 構文, MCP bindings

コードは Deno の Worker 内で実行され、MCP ツール呼び出しは postMessage 経由で親プロセスに委譲されます。Worker 作成時に Deno の権限を制限しているため、fetch や Deno.readFile などの API は使用できません。

ただし、MCP ツール経由では Notion の認証済みセッションでデータを読み書きしたり、Playwright でブラウザを操作したりできます。Worker の権限制限は「LLM が生成したコードが直接任意の URL にアクセスする」ことを防ぐためのもので、MCP 経由のアクセスは制限していません。自分の環境で自分が使う前提なので問題ないと考えています。

const worker = new Worker(workerUrl, {
  type: 'module',
  deno: {
    permissions: {
      net: false,
      read: false,
      write: false,
      env: false,
      run: false,
      ffi: false,
    },
  },
})

子サーバーへの接続

Code Mode MCP は内部で子 MCP サーバーに接続し、ツール呼び出しを中継します。

Claude Code
    ↓ stdio
Code Mode MCP (2ツール: search_docs, execute_code)
    ├── stdio + mcp-remote → Notion MCP (SSE)
    ├── stdio → Chrome DevTools MCP
    └── stdio → Playwright MCP

Notion MCP は OAuth 認証が必要で、stdio では直接繋げません。mcp-remote を使って SSE 経由でブリッジしています。認証フローは mcp-remote が処理してくれるので、Code Mode 側は stdio で mcp-remote と通信するだけで済みます。

await Promise.all([
  this.connectToNotion(), // mcp-remote 経由で SSE 接続
  this.connectToChromeDevTools(), // stdio 直接接続
  this.connectToPlaywright(), // stdio 直接接続
])

接続に失敗した場合は該当サーバーがスキップされ、他のサーバーは正常に動作します。未接続のサーバーは search_docs の一覧に表示されず、execute_code でそのサーバーのツールを呼び出すと Unknown tool エラーになります。
接続断時の自動リトライは未実装です。/mcp restart で手動再接続する運用です。

ハマりどころ: os error 35

発生条件: MCP サーバー(自身も stdio で親と通信している)の中から、StdioClientTransport で別の MCP サーバーを起動しようとしたとき。

Resource temporarily unavailable (os error 35)

原因: StdioClientTransport のデフォルト設定 stderr: 'inherit' が、親プロセス(Claude Code)の stdio 通信と干渉します。

解決: stderr: 'pipe' を指定して子プロセスの stderr を分離します。すべての子サーバー接続で同様の設定が必要です。

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', '@playwright/mcp@latest'],
  stderr: 'pipe', // すべての子サーバーで必須
})

ツール定義の最適化

最初の実装では execute_code の description に bindings 一覧とコード例を含めていました。

// Before: 1.3k tokens
description: `TypeScriptコードを実行して子MCPサーバーのツールを呼び出します。

利用可能なbindings:
- notion: { notion-search, notion-fetch, ... }
- playwright: { browser_click, ... }
...`

子サーバーが増えるほど description が肥大化します。改善として、description を最小限にし、bindings は search_docs で調べる運用にしました。

// After: 687 tokens
description: 'TypeScriptコードで子MCPサーバーを操作。bindingsはsearch_docsで確認。'

Code Mode 導入の結果

項目 Before After
MCP tools 36.6k tokens 4.4k tokens
ツール数 63 個 2 個
コンテクスト占有率 18.3% 2.2%

Code Mode の課題

LLM にとっての使いやすさ

普通の MCP は「ツール名を見れば何をするかわかる」ですが、Code Mode は「まず search_docs で調べて、TypeScript を書いて execute_code で実行」という 2 ステップを要求します。初見の LLM さんには使い方を教える必要があります。

自作前提

子サーバーの構成がハードコードされているので、使う人の環境に合わせてコード修正が前提です。

接続管理が脆弱

起動時に一度接続を試みるだけなので、途中で切れたらそのままです。Notion の OAuth が切れたり、Chrome が閉じられたりしたら、/mcp restart するまで使えません。

まとめ

  • MCP のツール定義でコンテクストを大量消費していたよ
  • メタな MCP サーバーで「調べ方」と「実行方法」の 2 ツールに圧縮できたよ
  • Deno を使うと TypeScript をそのまま実行できるよ
  • stderr: 'pipe' を忘れると os error 35 に遭遇
  • LLM にとっての使いやすさや、汎用性の面ではまだ課題が

コードは Deno + @modelcontextprotocol/sdk で書いています。
実装したコードは Gist にあります。同様の課題を持つ人の参考になれば。

https://gist.github.com/tgfjt/537f79fed12c580814bce4818f508556

Discussion