Tool Filter MCP

🚀 tool-filter-mcp

MCPプロキシサーバーで、正規表現ベースの拒否リストを使って上流のMCPサーバーからツールをフィルタリングします。

メンテナンス状況: ✅ はい (2025年秋)

🚀 クイックスタート

このツールは、コンテキストエンジニアリングにおいて無駄なトークンを最小限に抑えることを目的としています。現在の多くの主要なエージェント（例えばClaude Code）は、コンテキストからツールの説明を削除しません。このツールは、この問題を解決し、コンテキスト汚染を防ぎます。

✨ 主な機能

• ツールフィルタリング：正規表現パターンを使用して特定のツールをブロックします。
• ヘッダー透過：認証用のカスタムHTTPヘッダーを追加します。
• ゼロレイテンシー：キャッシュされたツールリストにより、オーバーヘッドを最小限に抑えます。
• フェイルファスト：接続問題または無効なパターンで即座にエラーを返します。
• 透過的なプロキシ：許可されたツール呼び出しを変更せずに上流に転送します。

📦 インストール

npx @respawn-app/tool-filter-mcp --upstream <url> --deny <patterns>

💻 使用例

基本的な使用法

.*_file$ パターンに一致するツールをフィルタリングします。

npx @respawn-app/tool-filter-mcp \
  --upstream http://localhost:3000/sse \
  --deny ".*_file$"

複数のパターン

カンマ区切りのパターンを使用します。

npx @respawn-app/tool-filter-mcp \
  --upstream http://localhost:3000/sse \
  --deny "get_file_text,create_new_file,replace_text"

認証ヘッダー付き

認証用のカスタムヘッダーを追加します。

npx @respawn-app/tool-filter-mcp \
  --upstream http://localhost:3000/sse \
  --header "Authorization: Bearer your-token-here" \
  --header "X-API-Key: your-api-key"

ヘッダーは環境変数の展開をサポートしています（アプリがまだ展開していない場合）。

npx @respawn-app/tool-filter-mcp \
  --upstream http://localhost:3000/sse \
  --header "Authorization: Bearer $AUTH_TOKEN"

Claude Codeとの連携

.mcp.json に追加します。

{
  "mcpServers": {
    "filtered-server": {
      "command": "npx",
      "args": [
        "@respawn-app/tool-filter-mcp",
        "--upstream",
        "http://localhost:3000/sse",
        "--deny",
        "dangerous_tool_1,dangerous_tool_2"
      ],
      "type": "stdio"
    }
  }
}

認証ヘッダー付き（環境変数の展開をサポート）。

{
  "mcpServers": {
    "filtered-server": {
      "command": "npx",
      "args": [
        "@respawn-app/tool-filter-mcp",
        "--upstream",
        "http://localhost:3000/sse",
        "--header",
        "Authorization: Bearer ${API_TOKEN}",
        "--header",
        "X-Custom-Header: $CUSTOM_VALUE"
      ],
      "type": "stdio"
    }
  }
}

📚 ドキュメント

CLIオプション

• --upstream <url> (必須): 上流のMCPサーバーURL（SSEトランスポート）
• --deny <patterns>: フィルタリングするツールのカンマ区切りの正規表現パターン
• --header <name:value>: 上流サーバーに渡すカスタムHTTPヘッダー（複数のヘッダーの場合は繰り返し指定可）
  • 形式: --header "Header-Name: value"
  • 環境変数の展開をサポート: $VAR または ${VAR}
  • 例: --header "Authorization: Bearer $TOKEN"

必要条件

• Node.js >= 20.0.0
• SSEトランスポートを持つ上流のMCPサーバー

📄 ライセンス

MIT