Nacos Mcp Router

nacos-mcp-router：検索、インストール、プロキシなどの機能を提供する MCP サーバー

英語 | 简体中文

概要

Nacos は、動的なサービスディスカバリーと設定、サービス管理のために設計された使いやすいプラットフォームです。クラウドネイティブアプリケーションやマイクロサービスプラットフォームを簡単に構築できます。

この MCP（Model Context Protocol）サーバーは、他の MCP サーバーを検索、インストール、プロキシするためのツールを提供します。ベクトル類似検索や複数プロバイダーの結果集約など、高度な検索機能も備えています。

Nacos-MCP-Router には、次の 2 つの動作モードがあります。

ルーターモード：デフォルトのモードです。MCP サーバーを介して、他の MCP サーバーの機能を推奨、振り分け、インストール、プロキシし、ユーザーが MCP サーバーのサービスをより便利に利用できるようにします。

プロキシモード：環境変数 MODE=proxy で指定します。簡単な設定により、SSE および stdio プロトコルの MCP サーバーを、ストリーミング可能な HTTP プロトコルの MCP サーバーに変換できます。

検索機能

Nacos-MCP-Router は、複数のプロバイダーを通じて強力な検索機能を提供します。

検索プロバイダー

1. Nacos プロバイダー

   • Nacos のサービスディスカバリーを使用して MCP サーバーを検索します
   • キーワードマッチングとベクトル類似検索に対応しています
   • ローカルの Nacos インスタンスと統合されています

2. Compass プロバイダー

   • COMPASS API エンドポイントに接続して検索を強化します
   • セマンティック検索と関連性スコアに対応しています
   • API エンドポイントを設定できます（デフォルト：https://registry.mcphub.io）

検索の設定

環境変数を使用して検索動作を設定します。

# YOUR COMPASS API endpoint (for Outer Provider called Compass Provider)
COMPASS_API_BASE=https://registry.mcphub.io

# Minimum similarity score for results (0.0 to 1.0)
SEARCH_MIN_SIMILARITY=0.5

# Maximum number of results to return
SEARCH_RESULT_LIMIT=10

検索 API

検索機能は MCP インターフェースから利用できます。

// Search for MCP servers
const results = await searchMcpServer(
  "Find MCP servers for natural language processing",
  ["nlp", "language"]
);

結果には次の情報が含まれます。

• サーバー名と説明
• プロバイダー情報
• 関連性スコア
• その他のメタデータ

クイックスタート

Python

ルーターモード

ツール

1. search_mcp_server
   • タスクとキーワードで MCP サーバーを検索します。
   • 入力：
     • task_description（string）：タスクの説明
     • key_words（string）：タスクのキーワード
   • 戻り値：タスクの完了に必要な MCP サーバーのリストと手順。
2. add_mcp_server
   • MCP サーバーを追加します。MCP サーバーが stdio サーバーの場合、このツールはインストールして接続を確立します。MCP サーバーが sse サーバーの場合は、接続を確立します。
   • 入力：
     • mcp_server_name（string）：MCP サーバーの名前。
   • 戻り値：MCP サーバーのツール一覧と、各ツールの使用方法。
3. use_tool
   • このツールは、LLM が任意の MCP サーバーのツールを使用できるようにします。リクエストを対象の MCP サーバーにプロキシします。
   • 入力：
     • mcp_server_name（string）：LLM が呼び出す対象の MCP サーバー名。
     • mcp_tool_name（string）：LLM が呼び出す対象の MCP サーバーのツール名。
     • params（map）：MCP ツールのパラメーター。
   • 戻り値：対象の MCP サーバーから返された結果。

使用方法

uv を使用する（推奨）

uv を使用する場合、特別なインストールは必要ありません。
uvx を使用して、nacos-mcp-router を直接実行します。

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
uvx nacos-mcp-router@latest

PIP を使用する

または、pip を使用して nacos-mcp-router をインストールできます。

pip install nacos-mcp-router

インストール後、スクリプトとして実行できます（例として、Nacos がローカルマシンのスタンドアロンモードでデプロイされている場合）。

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
python -m nacos_mcp_router

Docker を使用する

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=$TRANSPORT_TYPE nacos/nacos-mcp-router:latest

Cline、Cursor、Claude およびその他のアプリケーションでの使用方法

アプリケーションの MCP 設定に以下を追加してください。

• uvx を使用する場合

{
    "mcpServers":
    {
        "nacos-mcp-router":
        {
            "command": "uvx",
            "args":
            [
                "nacos-mcp-router@latest"
            ],
            "env":
            {
                "NACOS_ADDR": "<NACOS-ADDR>, optional, default is 127.0.0.1:8848",
                "NACOS_USERNAME": "<NACOS-USERNAME>, optional, default is nacos",
                "NACOS_PASSWORD": "<NACOS-PASSWORD>, required"
            }
        }
    }
}

command フィールドに uvx 実行ファイルのフルパスを指定する必要がある場合があります。MacOS/Linux では which uvx、Windows では where uvx を実行すると確認できます。

• docker を使用する場合

{
  "mcpServers": {
    "nacos-mcp-router": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network", "host",  "-e", "NACOS_ADDR=<NACOS-ADDR>", "-e",  "NACOS_USERNAME=<NACOS-USERNAME>", "-e", "NACOS_PASSWORD=<NACOS-PASSWORD>" ,"-e", "TRANSPORT_TYPE=stdio", "nacos/nacos-mcp-router:latest"
      ]
    }
  }
}

プロキシモード

プロキシモードでは、SSE および stdio プロトコルの MCP サーバーを、ストリーミング可能な HTTP プロトコルの MCP サーバーに変換できます。

使用方法

プロキシモードの使用方法はルーターモードと似ていますが、パラメーターが少し異なります。Docker によるデプロイを推奨します。

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=streamable_http -e MODE=proxy -e PROXIED_MCP_NAME=$PROXIED_MCP_NAME  nacos/nacos-mcp-router:latest

環境変数の設定

パラメーター	説明	デフォルト値	必須	備考
NACOS_ADDR	Nacos サーバーのアドレス	127.0.0.1:8848	いいえ	Nacos サーバーのアドレス。例：192.168.1.1:8848。注：ポートを含めてください。
NACOS_USERNAME	Nacos のユーザー名	nacos	いいえ	Nacos のユーザー名。例：nacos。
NACOS_PASSWORD	Nacos のパスワード	-	はい	Nacos のパスワード。例：nacos。
COMPASS_API_BASE	強化検索用の COMPASS API エンドポイント	https://registry.mcphub.io	いいえ	デフォルトの COMPASS API エンドポイントを上書きします
SEARCH_MIN_SIMILARITY	類似度の最小スコア（0.0-1.0）	0.5	いいえ	類似度の最小スコアで検索結果をフィルタリングします
SEARCH_RESULT_LIMIT	返す結果の最大数	10	いいえ	検索結果の数を制限します
NACOS_NAMESPACE	Nacos 名前空間	public	いいえ	Nacos 名前空間。例：public
TRANSPORT_TYPE	トランスポートプロトコルの種類	stdio	いいえ	トランスポートプロトコルの種類。選択肢：stdio、sse、streamable_http。
PROXIED_MCP_NAME	プロキシ対象の MCP サーバー名	-	いいえ	プロキシモードで、変換する MCP サーバー名を指定します。最初に Nacos に登録する必要があります。
MODE	動作モード	router	いいえ	使用可能な選択肢：router、proxy。
PORT	TRANSPORT_TYPE が sse または streamable_http の場合のサービスポート	8000	いいえ
ACCESS_KEY_ID	Aliyun RAM アクセスキー ID	-	いいえ
ACCESS_KEY_SECRET	Aliyun RAM アクセスキーシークレット	-	いいえ

typescript

Cline、Cursor、Claude およびその他のアプリケーションでの使用方法

{
  "mcpServers": {
    "nacos-mcp-router": {
      "command": "npx",
      "args": [
        "nacos-mcp-router@latest"
      ],
      "env": {
        "NACOS_ADDR": "<NACOS-ADDR>, optional, default is 127.0.0.1:8848",
        "NACOS_USERNAME": "<NACOS-USERNAME>, optional, default is nacos",
        "NACOS_PASSWORD": "<NACOS-PASSWORD>, required"
      }
    }
  }
}

ライセンス

nacos-mcp-router は Apache 2.0 ライセンスのもとでライセンスされています。Apache 2.0 ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。