MCP Nexus

MCP Nexus は、Model Context Protocol のためのローカルファーストのインテリジェントルーターです。 あなたの AI ハーネスは 1 つの MCP エンドポイント( Nexus )に接続し、Nexus は舞台裏で実際の MCP サーバーをすべて管理します。ツールのインデックス化、必要に応じた機能の発見、サーバーの遅延起動、ルーティングされた呼び出しの実行、そしてローカルでの使用状況から学習して時間の経過とともに結果のランキングを向上させます。

Before                                With MCP Nexus

AI Harness                            AI Harness
  ├── GitHub MCP   (30 tools)           └── mcp-nexus (4 control tools)
  ├── Jira MCP      (25 tools)              ├── search_capabilities
  ├── Slack MCP     (20 tools)              ├──── describe_capabilities
  ├── Figma MCP     (18 tools)              ├──── execute_capability
  ...                                   └──── search_servers
  ~90+ tool schemas in context                  │
                                     (everything else stays indexed
                                      on disk until actually needed)

なぜ必要か

接続された MCP サーバーはそれぞれツールスキーマをモデルのコンテキストに追加します。10 台のサーバーを接続すると、モデルがほとんど使わない定義に数万トークンを費やし、ツール選択の品質が低下します。

Nexus はモデルを反転させます。ダウンストリームのスキーマをすべてコンテキストにプッシュする代わりに、軽量な機能インデックスをディスクに保持し、小さなコントロールプレーンを提供します。エージェントは必要なときに機能を発見し( search_capabilities )、選択した機能の正確なスキーマだけを調べ( describe_capabilities )、Nexus を介して実行します( execute_capability )。設定、インデックス、分析、学習されたシーケンスなど、すべての状態は .mcp-nexus/ にローカルに保存されます。

Related MCP server: Master MCP Server

クイックスタート

# 1. Scaffold a project config
npx @fyrlabs/mcp-nexus init

# 2. Add downstream MCP servers (anything runnable over stdio)
npx @fyrlabs/mcp-nexus add github -- npx -y @modelcontextprotocol/server-github
#    or import an existing config:
npx @fyrlabs/mcp-nexus import --from claude

# 3. Point your harness at Nexus (see docs/harness-setup.md)

ハーネス設定( Claude Code 、 Cursor 、 Codex 、その他の MCP クライアント ):

{
  "mcpServers": {
    "mcp-nexus": {
      "command": "npx",
      "args": ["-y", "@fyrlabs/mcp-nexus"]
    }
  }
}

Nexus は作業ディレクトリから上に移動して project-mcp.json を自動的に見つけるか、--config ./path/to/nexus.json を渡します。

次に、エージェントの視点から:

search_capabilities  { "query": "find comments people left on my PR" }
→ github.review_comments.list  score=0.94 ...

describe_capabilities { "capabilityIds": ["github.review_comments.list"] }
→ exact input schema

execute_capability   { "capabilityId": "github.review_comments.list",
                       "arguments":  { ... } }
→ forwarded verbatim to the right server, started on demand

モデルに公開されるものとローカルに保持されるもの

ハイライト

• ローカルファースト。 クラウドサービスもアカウントもテレメトリもありません。.mcp-nexus/ を削除すると、学習された状態はすべて消去されます。

• 遅延ライフサイクル。 ダウンストリームサーバーはタスクが必要なときだけ起動し、階層化されたアイドルタイムアウト( ホット / ウォーム / コールド )後に停止します。

• ハイブリッド検索。 重み付けされたフィールドに対する BM25 語彙ランキング、正確な ID / ツールマッチング、エイリアス展開( pr → pull request 、設定可能 )、およびオプションのセマンティックレイヤー用のプラグ可能な EmbeddingProvider インターフェース。

• 適応的ランキングと説明。 各結果にはシグナルの内訳が含まれます。ブロックされた機能は決して提案されません。

• シーケンス予測。 繰り返される使用パターンをローカルで学習し、次に起こりそうな機能のブーストに使用します。予測は自動実行されません。

• ネイティブ依存関係ゼロ。 ストレージには Node 組み込みの node:sqlite を使用します。このパッケージのインストール時にコンパイルは発生しません。

• ハーネス非依存。 MCP stdio を話す任意のハーネスを Nexus の前に置くことができます。

要件

• Node.js >= 22.5 ( 24 LTS 推奨 )

ドキュメント

• 設定リファレンス — すべてのフィールド、解決順序、ストレージスキーマ

• CLI リファレンス — すべてのコマンドとフラグ

• アーキテクチャ — スコアリングモデル、ストレージスキーマ

• ハーネスセットアップ — Claude Code 、 Cursor 、 Codex 、汎用 MCP クライアント

• examples/project-mcp.json — 注釈付きスターター設定

開発

git clone https://github.com/fyrlabs/mcp-nexus && cd mcp-nexus
npm install
npm run build       # tsc -> dist/
npm run test        # vitest (unit + integration, mirrors src/ structure under src/tests/)
npm run typecheck   # strict tsc, no emit
npm run lint        # eslint

統合テストでは、@modelcontextprotocol/server-everything パッケージを実際のダウンストリーム stdio サーバーとして起動し、完全なランタイムを通じて実行をルーティングします。パッケージを解決できない場合は自動的にスキップされます。

コントリビューションの規約( コミット、バージョニング、プルリクエスト )については AGENTS.md を参照してください。

プライバシー

Nexus は設定キャッシュ、インデックス、分析を .mcp-nexus/( または XDG データディレクトリ )に保存します。ルーター自体が外部に送信することはありません。外部の埋め込みプロバイダーを設定した場合、機能テキスト( タイトル / 説明 / キーワード )のみが送信されます。引数、シークレット、分析は送信されません。生のツール引数は永続化されません。

ライセンス

Apache-2.0