mcp-server-nacos: A Nacos MCP server
2025.04.14
1
Python动态服务发现配置管理微服务平台开发效率数据库
nacos-mcp-server 是一个基于 Nacos 的 MCP（Model Context Protocol）服务器，主要用于与 Nacos 集群进行交互和自动化操作。它提供了多种工具，用于搜索和读取 Nacos 中的命名空间、服务和配置信息。当前版本仅支持读取、搜索和列表操作，不支持写入操作。该服务器适用于动态服务发现、配置管理和微服务平台的构建。
View on GitHub
Overview
基本能力
产品定位
nacos-mcp-server 是一个用于与 Nacos 集群交互的 MCP 服务器，主要用于动态服务发现、配置管理和微服务平台的构建。
核心功能
- 命名空间管理：支持列出 Nacos 集群中的命名空间。
- 服务管理：支持列出指定命名空间下的服务，获取服务的详细信息，以及列出服务的实例和订阅者。
- 配置管理：支持列出指定命名空间下的配置，获取配置的详细信息，以及查看配置的历史记录和监听者。
适用场景
- 微服务架构：用于动态服务发现和配置管理。
- 云原生应用：帮助构建和管理云原生应用。
- 自动化运维：通过自动化工具管理 Nacos 集群中的服务和配置。
工具列表
list_namespaces：列出 Nacos 集群中的命名空间。list_services：列出指定命名空间下的服务。get_service：获取指定服务的详细信息。list_service_instances：列出指定服务的实例。list_service_subscribers：列出指定服务的订阅者。list_configs：列出指定命名空间下的配置。get_config：获取指定配置的详细信息。list_config_history：列出配置的发布历史。get_config_history：获取配置的特定历史记录。list_config_listeners：列出配置的监听者。list_listened_configs：列出特定客户端 IP 订阅的配置。
常见问题解答
- Nacos 版本要求：需要 Nacos 3.0.0 及以上版本。
- Python 版本要求：需要 Python 3.x，推荐 3.13 及以上版本。
- 写入操作支持：当前版本不支持写入操作，未来版本计划支持。
使用教程
使用依赖
- Nacos 版本：3.0.0 及以上。
- Python 版本：3.x，推荐 3.13 及以上。
安装教程
使用 uv（推荐）
无需特定安装，直接使用 uvx 运行 nacos-mcp-server。
使用 PIP
pip install mcp-server-nacos
安装完成后，运行：
python -m mcp_server_nacos
调试方式
- 配置 Claude Desktop：在
claude_desktop_config.json中添加以下配置：
"mcpServers": {
"git": {
"command": "uvx",
"args": [
"nacos-mcp-server",
"--host",
"your_nacos_host",
"--port",
"your_nacos_main_port, such as 8848",
"--access_token",
"your_nacos_access_token, get from `login` api: /nacos/v3/auth/user/login with `username` and `password`"
],
}
}
- 本地开发：克隆仓库，修改代码后测试。
{
"mcpServers": {
"mcp-server-nacos": {
"command": "uv",
"args": [
"--directory",
"/<path to mcp-server-nacos>/src/mcp_server_nacos",
"run",
"mcp-server-nacos"
]
}
}