mcp-server-nacos: Nacos MCP サーバー

概要

Nacosは、動的なサービスの検出と構成、そしてサービス管理のために設計された、使いやすいプラットフォームです。クラウドネイティブアプリケーションとマイクロサービスプラットフォームを容易に構築できます。

このMCP（モデルコンテキストプロトコル）サーバーは、Nacosのインタラクションと自動化を目的としています。このサーバーは、大規模言語モデルを介してNacosクラスター内のnamespace 、 service 、およびconfiguration関連情報を検索および読み取るためのツールを提供します。

mcp-server-nacos現在開発初期段階にあります。サーバーの開発と改良に伴い、機能と利用可能なツールは変更および拡張される可能性があります。また、 mcp-server-nacos現在のバージョンでは読み取り、検索、リスト操作のみをサポートしており、書き込み操作はサポートしていません。書き込み操作は将来のバージョンでサポートされる予定です。

このmcp-server-nacos必要なバージョンについてもう 1 つ注意すべき点があります。

ツール

1. list_namespaces

   • 現在の Nacos クラスター内の名前空間のリストを取得します。

   • 入力：

     • なし

   • 返される値: 現在の Nacos クラスター内の名前空間のリスト。

2. list_services

   • このツールは、指定された名前空間の下にあるサービスのリストを取得します。レスポンスの形式は、 withInstancesパラメータによって異なります。withInstances withInstances=true ：インスタンス（ ServiceDetailInfoオブジェクト）を含むサービスの詳細を返します。withInstances withInstances=false ：インスタンス（ ServiceViewオブジェクト）を含まないサービスメタデータを返します。**注意：** withInstances=trueの場合、APIのメモリとネットワーク負荷が過度に高くなる可能性があります。少数のサービス、または1つのサービスのみを含むインスタンスリストを取得する場合は、 List Service InstancesでwithInstances=false使用することをお勧めします。

   • 入力：

     • pageNo (数値): 現在のページ番号。デフォルトは 1 です。

     • pageSize (数値): 各ページのサービスのサイズ。デフォルトは 100 です。

     • namespaceId (文字列、オプション): サービスの namespaceId。指定されていない場合は、デフォルトはpublicです。

     • groupNameParam (文字列、オプション): サービスの groupName パターン。デフォルトは null で、存在しない場合はすべてのグループを意味します。

     • serviceNameParam (文字列、オプション): サービスの serviceName パターン。デフォルトは null で、存在しない場合はすべてのサービスを意味します。

     • ignoreEmptyService (bool、オプション): 結果内の空のサービスを無視するかどうか。デフォルトは true。

     • withInstances (bool、オプション): 結果の各サービスの下にインスタンスが含まれているかどうか。推奨。デフォルトは false。

   • 返される値: 指定された名前空間の下にあるサービスのリスト。

3. get_service

   • このツールは、インスタンス リストを除くメタデータやクラスターなど、指定されたサービスの詳細情報を取得します。

   • 入力：

     • namespaceId (文字列、オプション): サービスの namespaceId。指定されていない場合は、デフォルトはpublicです。

     • groupName (文字列、オプション): サービスの groupName パターン。指定されていない場合は、デフォルトはDEFAULT_GROUPです。

     • serviceName (文字列): サービスの serviceName パターン (必須)。

   • 返される値: 指定されたサービスの詳細情報。

4. list_service_instances

   • このツールは、指定されたサービスのインスタンスのリストを取得します。

   • 入力：

     • namespaceId (文字列、オプション): サービスの namespaceId。指定されていない場合は、デフォルトはpublicです。

     • groupName (文字列、オプション): サービスの groupName パターン。指定されていない場合は、デフォルトはDEFAULT_GROUPです。

     • serviceName (文字列): サービスの serviceName パターン (必須)。

     • clusterName (文字列、オプション): サービス内のインスタンスのクラスター名。オプションで、デフォルトは null で、すべてのクラスターに一致することを意味します。

   • 戻り値: 指定されたサービスのインスタンスのリスト。

5. list_service_subscribers

   • このツールは、指定されたサービスの加入者のリストを取得します。

   • 入力：

     • pageNo (数値): 現在のページ番号。デフォルトは 1 です。

     • pageSize (数値): 各ページのサービス サブスクライバーのサイズ。デフォルトは 100 です。

     • namespaceId (文字列、オプション): サービスの namespaceId。指定されていない場合は、デフォルトはpublicです。

     • groupName (文字列、オプション): サービスの groupName パターン。指定されていない場合は、デフォルトはDEFAULT_GROUPです。

     • serviceName (文字列): サービスの serviceName パターン (必須)。

     • aggregation (bool、オプション): クラスター全体からの集約かどうか。

   • 返される値: 指定されたサービスの加入者のリスト。

6. list_configs

   • このツールは、指定された名前空間の下にある構成のリストを取得します。

   • 入力：

     • pageNo (数値): 現在のページ番号。デフォルトは 1 です。

     • pageSize (数値): 各ページの構成のサイズ。デフォルトは 100 です。

     • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

     • groupName (文字列、オプション): 構成の groupName パターン。デフォルトの null はすべてのグループを意味します。

     • dataId (文字列、オプション): 構成の dataId パターン。デフォルトの null はすべて dataId を意味します。

     • type (文字列、オプション): 構成のタイプ。デフォルトの null はすべてのタイプを意味します。

     • configTags (文字列、オプション): 構成のタグ。デフォルトの null はすべてのタグを意味します。

     • appName (文字列、オプション): 構成の appName。デフォルトは null で、すべての appName を意味します。

     • search (文字列、オプション): リスト設定の検索方法。デフォルトは、 blur 、オプションの値はaccurate 。

   • 戻り値: 指定された名前空間の下にある構成のリスト。

7. get_config

   • 指定された構成の詳細を取得します。

   • 入力：

     • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

     • groupName (文字列): 構成のグループ名。必須。

     • dataId (文字列): 構成の dataId。必須。

   • 返される値: 指定された構成の詳細。

8. list_config_history

   • このツールは、構成の完全な公開履歴を取得します。

   • 入力：

     • pageNo (数値): 現在のページ番号。デフォルトは 1 です。

     • pageSize (数値): 各ページの構成履歴レコードのサイズ。デフォルトは 100 です。

     • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

     • groupName (文字列): 構成のグループ名。必須。

     • dataId (文字列): 構成の dataId。必須。

   • 戻り値: 指定された名前空間の下にある構成のリスト。

9. get_config_history

   • 構成の特定の履歴変更レコードを取得します。

   • 入力：

     • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

     • groupName (文字列): 構成のグループ名。必須。

     • dataId (文字列): 構成の dataId。必須。

     • nid (数値): 構成履歴レコードの実際の ID、リスト構成履歴ツールのidフィールドから取得します。

   • 返される値: 構成の履歴変更レコード。

10. list_config_listeners

• 特定の構成にサブスクライブされているリスナーのリストを取得します。

• 入力：

  • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

  • groupName (文字列): 構成のグループ名。必須。

  • dataId (文字列): 構成の dataId。必須。

  • aggregation (bool、オプション): クラスター全体からの集約かどうか。

• 返される値: 特定の構成にサブスクライブされているリスナーのリスト。

11. list_listened_configs

• 特定のクライアント IP アドレスによってサブスクライブされている構成のリストを取得します。

• 入力：

  • namespaceId (文字列、オプション): 構成の namespaceId。指定されていない場合はデフォルトはpublicです。

  • ip (文字列): 構成リスナーのクライアント IP。必須。

  • aggregation (bool、オプション): クラスター全体からの集約かどうか。

• 返される値: 特定のクライアント IP アドレスによってサブスクライブされている構成を一覧表示します。

Related MCP server: Sonos MCP Server

インストール

uvの使用（推奨）

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

PIPの使用

あるいは、pip 経由でmcp-server-nacosをインストールすることもできます。

インストール後、次のコマンドを使用してスクリプトとして実行できます。

構成

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

commandフィールドにuvx実行ファイルへのフルパスを入力する必要があるかもしれません。これは、MacOS/Linuxの場合はwhich uvx 、Windowsの場合はwhere uvx実行することで取得できます。

発達

ローカル開発を行う場合は、次の手順に従ってください。

1. このリポジトリをローカル環境にクローンします。

2. 必要な機能を実装するには、 src/mcp_server_nacos内のコードを変更します。

3. Claudeデスクトップアプリを使ってテストします。claude_desktop_config.jsonに以下のコードを追加してください。

ライセンス

mcp-server-nacos は Apache 2.0 ライセンスに基づきます。つまり、Apache 2.0 ライセンスの条件に従い、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。