mcp-anything

世界の（ほぼ）あらゆるMCPサーバーを発見・呼び出しできる、たった一つのMCPサーバー。

mcp-anything は メタ MCPサーバーです。ホスト（Claude Desktop、Claude Code、Cursorなど）に数十のMCPサーバーを設定する代わりに、たった一つを設定するだけです。公式の MCPレジストリ をローカルにインデックスし、モデルがサーバーを検索・調査・ツールをその場で呼び出せるようにする5つの小さな メタツール を公開します。数千ものツールスキーマをコンテキストウィンドウに読み込む必要は一切ありません。

Host / LLM
    │  (5 meta-tools, constant context cost)
    ▼
mcp-anything ──── local BM25 index ◄──┬── official MCP registry   (moderated, richest metadata)
    │        (cross-source dedupe,    ├── PulseMCP    (~22k servers, stars & downloads)
    │         popularity-boosted      ├── npm         (~67k packages tagged mcp)
    │         ranking)                └── Glama       (~75k indexed servers)
    │
    │  security policy: SSRF guard · stdio allowlist · secrets injection · timeouts
    ▼
downstream MCP servers   (streamable-http / sse / stdio via npx·uvx)

なぜ

• 発見: 何千ものMCPサーバーが存在しますが、ホストが知っているのは手動で設定したものだけです。

• コンテキスト: 多くのサーバーを読み込むとコンテキストウィンドウを消費します。メタツールはコストを一定に保ちます。モデルは2段階（検索→調査→呼び出し）で機能を検索します。これはAnthropicのTool Searchと同じパターンです。

• 設定は一つ: MCPクライアント設定にサーバーごとに1エントリではなく、単一のエントリで済みます。

クイックスタート

# Run directly (Node >= 20):
npx mcp-anything sync     # first-time index download (~few seconds)
npx mcp-anything serve    # start the meta-MCP server on stdio

Claude Code

claude mcp add anything -- npx -y mcp-anything serve

Claude Desktop / その他のホスト

{
  "mcpServers": {
    "anything": {
      "command": "npx",
      "args": ["-y", "mcp-anything", "serve"]
    }
  }
}

あとはモデルに 「PostgresをクエリできるMCPサーバーを見つけて、そのツールを一覧表示して」 などと頼むだけです。モデルはメタツールを自分で使います。

CLI

mcp-anything sync             # refresh the registry index
mcp-anything search "weather" # search the index from your terminal
mcp-anything serve            # stdio MCP server (default command)

メタツール

セキュリティモデル

LLMを公開レジストリの任意のサーバーに接続することは、デフォルトでは危険です。mcp-anything は保守的なデフォルトを備え、すべての緩和を明示的にします。

• リモートサーバー（streamable-http / sse）: 許可されますが、プライベート/ループバック/リンクローカルアドレス（クラウドメタデータエンドポイント 169.254.169.254 など）と平文の http: はブロックされます。これはレジストリエントリがネットワーク内を指す場合のSSRFガードです。remote.allowPrivateNetwork で無効化できます（ローカル開発専用）。

• Stdioサーバー（npx / uvx プロセスの起動）: デフォルトで無効。 公開レジストリからパッケージを実行することは、マシン上での任意コード実行です。明示的なパッケージごとの許可リストでのみ有効にしてください。

• シークレット: APIキーはインデックス化もモデルに公開もされません。設定でサーバーごとにマッピングし、接続時に注入されます（リモートはヘッダー、stdioは環境変数）。

• 信頼できない出力: ダウンストリームサーバーからの結果やツールの説明はサードパーティデータとしてラベル付けされ、モデルがデータとして扱い、指示として扱わないようにします。これによりプロンプトインジェクションのリスクは 減少 しますが、排除はされません。SECURITY.md を参照してください。

• 制限: 接続/呼び出しのタイムアウト、レスポンスサイズの切り詰め、セッションプールの上限。

設定

~/.config/mcp-anything/config.json（または --config <path>、または MCP_ANYTHING_CONFIG）:

{
  "registryUrl": "https://registry.modelcontextprotocol.io",
  "sources": ["official"],
  "qualityFilter": true,
  "cacheTtlHours": 24,
  "maxServers": 10000,
  "policy": {
    "remote": {
      "enabled": true,
      "allowPrivateNetwork": false,
      "headers": {
        "io.github.example/github": { "Authorization": "Bearer ghp_..." }
      }
    },
    "stdio": {
      "enabled": false,
      "allowPackages": ["@modelcontextprotocol/server-filesystem"],
      "env": {
        "io.github.example/postgres": { "DATABASE_URL": "postgres://..." }
      }
    },
    "limits": {
      "callTimeoutMs": 60000,
      "connectTimeoutMs": 20000,
      "maxSessions": 8,
      "maxResultChars": 100000
    }
  }
}

すべてのフィールドはオプションです。上記のデフォルト（例のヘッダー/envを除く）は、設定なしで得られるものです。registryUrl は公式REST APIを実装する任意のレジストリ（プライベート/セルフホストのものも含む）を受け入れます。

インデックスソース — 広くカバー

sources はエコシステムのどの程度をインデックスするかを制御します:

{ "sources": ["official", "pulsemcp", "npm"] }

複数のカタログに登場するエントリは、正規化されたリポジトリURLとパッケージ識別子で 重複排除 されます。最も信頼できるソースがアイデンティティを勝ち取り、メタデータは他からバックフィルされ、スターとダウンロード数は累積します。ランキングはBM25関連性と対数スケールの人気ブースト（公式レジストリエントリにはボーナス）を組み合わせるため、search_mcp_servers は機能のメンテナンスされた実装を、100番目の放棄されたクローンではなく表面化させます。qualityFilter（デフォルトオン）は、接続手段がなく説明も使えないエントリを除外します。広いソースでは、より多く が良いのは、ジャンクがトップ5に入らない場合のみです。失敗したソースは優雅に劣化します。同期は他のソースが返したものを保持し、失敗を報告します。

設計ノート

• 語彙検索、埋め込みではない。 完全にローカル、APIコストゼロ、インデックス構築ステップなし。ツール発見には、キーワード検索とファジーマッチングが実際には同等に機能します（AnthropicのTool SearchもBM25/regexで同じ判断をしました）。

• ステートレス呼び出しではなくセッション。 MCPはセッション指向（initializeハンドシェイク、機能ネゴシエーション）です。ダウンストリーム接続はプールされ、LRU退避で呼び出し間で再利用されます。

• 優雅な劣化。 レジストリに到達できない場合、最後に同期されたキャッシュが機能し続けます。

先行技術と位置付け

この分野は活発です: MetaMCP や他のゲートウェイは 設定したサーバー を集約します。ComposioのRubeは 独自のキュレーションカタログ にルーティングします。ホストはネイティブのツール検索を成長させています。mcp-anything のニッチはオープンな組み合わせです: 公開レジストリをカタログとして、ローカルファーストの単一バイナリ、そして明示的なセキュリティポリシー — クラウドアカウント不要、キュレーションのロックインなし、プライベートレジストリに対してセルフホスト可能。

ロードマップ

• ランキングにおけるライブヘルスチェックと結果品質シグナル

• 人気サーバーの tools/list をインデックス化した、サーバー単位ではなくツール単位の検索

• それを必要とするリモートサーバー向けのOAuthフローパススルー

• stdioサーバー向けの許可リストに代わるコンテナ/Wasmサンドボックス

• フェデレーションと重複排除を備えた複数レジストリ

• オプションのstreamable-httpサーバーモード（共有/チーム展開用）

開発

npm install
npm test              # unit + end-to-end (mock registry + real downstream MCP server)
npm run typecheck
npm run build
node scripts/smoke.mjs  # spawns the built CLI as a real stdio MCP server

CONTRIBUTING.md を参照してください。ライセンスは MIT です。