Nacos MCP Server

Nacos MCP Server 是一个模型上下文协议(Model Context Protocol)服务器，为MCP客户端(如Claude Desktop)提供与火山引擎MSE服务交互的能力。可以基于自然语言对Nacos注册中心实例资源进行全链路管理，支持实例的查询、创建、更新操作，实现Nacos资源的高效管理。

版本	v0.1.0
描述	基于 MCP 管理 Nacos 资源，智能化注册中心管理
分类	容器与中间件
标签	注册中心 Nacos

Tools

本 MCP Server 产品提供以下 Tools (工具/能力):

Tool 1: get_nacos_registry

类型

SaaS

详细描述

该工具允许您便捷查看火山引擎Nacos注册中心的详情。

调试所需的输入参数:

输入：

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
         "description": "The ID of the nacos registry to query.",
         "type": "string"
       },
      "region": {
        "description": "区域，默认为 cn-beijing",
        "type": "string"
      }
    },
    "required": [
      "id"
    ]
  },
  "name": "get_nacos_registry",
  "description": "查询您账号下拥有的Nacos实例的详情。"
}

输出：

• 返回您账号下拥有的Nacos实例详情，包含实例名称、实例规格、创建时间等信息。

最容易被唤起的 Prompt示例

查询火山引擎 Nacos 的实例详情。

Tool 2: create_nacos_registry

类型

SaaS

详细描述

该工具允许您便捷创建火山引擎Nacos注册中心实例。

调试所需的输入参数:

输入：

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "description": "The name of the Nacos registry. If not provided, a random name will be generated.",
        "type": "string"
      },
      "region": {
        "description": "区域，默认为 cn-beijing",
        "type": "string"
      },
      "VpcId": {
        "description": "The ID of the VPC where the Nacos registry will be deployed. It cannot be empty.",
        "type": "string"
      },
      "SubnetId1": {
        "description": "The first subnet ID. At least two non-empty SubnetIds are required.",
        "type": "string"
      },
      "SubnetId2": {
        "description": "The second subnet ID.",
        "type": "string"
      },
      "SubnetId3": {
        "description": "The third subnet ID.",
        "type": "string"
      }
    },
    "required": ["VpcId"]
  },
  "name": "create_nacos_registry",
  "description": "创建Nacos注册中心实例。"}

输出：

• 返回您账号下创建的Nacos注册中心实例 ID。

最容易被唤起的 Prompt示例

创建火山引擎 Nacos 注册中心实例。

Tool 3: update_registry_info

类型

SaaS

详细描述

该工具允许您便捷更新Nacos注册中心元数据。

调试所需的输入参数:

输入：

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
           "description": "The new name of the Nacos registry that needs to update its name.",
           "type": "string"
       },
      "region": {
        "description": "区域，默认为 cn-beijing",
        "type": "string"
      },
      "id": {
         "description": "The ID of the nacos registry to rename.",
         "type": "string"
       },
    },
    "required": [
      "id",
      "name"
    ]
  },
  "name": "update_registry_info",
  "description": "更新Nacos注册中心元数据。"
}

输出：

• 返回请求的Response的元数据。

最容易被唤起的 Prompt示例

更新火山引擎 Nacos 注册中心实例的元数据。

Tool 4: list_nacos_registries

类型

SaaS

详细描述

该工具允许您便捷查看火山引擎Nacos注册中心实例列表。

调试所需的输入参数:

输入：

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "region": {
        "description": "区域，默认为 cn-beijing",
        "type": "string"
      }
    },
    "required": []
  },
  "name": "list_nacos_registries",
  "description": "查询您账号下拥有的所有Nacos注册中心实例的列表。"
}

输出：

• 返回您账号下拥有的Nacos实例列表，包含实例名称、实例ID、创建时间等信息。

最容易被唤起的 Prompt 示例

列举火山引擎 Nacos 的实例列表。

可适配平台

方舟，python，cursor

服务开通链接 (整体产品)

https://console.volcengine.com/nacos

鉴权方式

火山引擎，从 volcengine 管理控制台获取 volcengine 访问密钥 ID、秘密访问密钥和区域，请在.env文件中设置相关环境变量

环境变量

以下环境变量可用于配置MCP服务器:

环境变量	描述	默认值
VOLCENGINE_ACCESS_KEY	火山引擎账号 ACCESS KEY	-
VOLCENGINE_SECRET_KEY	火山引擎账号 SECRET KEY	-
VOLCENGINE_REGION	火山引擎 MSE region	-
VOLCENGINE_ENDPOINT	Volcengine endpoint	-
MCP_SERVER_PORT	MCP server listening port	8000

安装部署

系统依赖

• 安装 Python 3.10 或者更高版本
• 安装 uv
  • 如果是linux系统

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  • 如果是window系统

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• 同步依赖项并更uv.lock:

  uv sync

• 构建mcp server:

  uv build

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-nacos.

本地配置

添加以下配置到你的 mcp settings 文件中

{
  "mcpServers": {
    "mcp-server-nacos": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_nacos",
        "run",
        "mcp-server-nacos"
      ]
    }
  }
}

在不同平台的配置

方舟

体验中心

[示例如下]

1. 查看MCP Server 详情 在大模型生态广场，选择合适的MCP Server，并查看详情
2. 选择MCP Server即将运行的平台 检查当前MCP Server 已适配的平台，并选择合适的平台
3. 查看并对比可用的Tools 仔细查看可用的Tools的功能描述与所需的输入参数，并尝试运行对应的功能。
4. 获取专属的URL或代码示例 检查账号登录状态与服务开通情况，生成唯一URL
5. 去对应的Client的平台进行使用 点击快捷跳转按钮，前往方舟平台的体验中心进行对应MCP Server的体验

产品截图/视频 - optional

Cursor

部署

[示例如下]

UVX

{
  "mcpServers": {
    "mcp-server-nacos": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_nacos",
        "mcp-server-nacos"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret"
      }
    }
  }
}

License

volcengine/mcp-server is licensed under the MIT License.