nacos-mcp-server

基于 Model Context Protocol 的 Nacos 2.x 配置中心和服务发现 MCP 服务器，通过 stdio 与 AI 助手通信，提供只读查询和可选写入能力。

配置

通过环境变量进行配置：

| 环境变量 | 必填 | 默认值 | 说明 | |---------|------|--------|------| | NACOS_SERVER_URL | 是 | - | Nacos 服务器地址，例如 http://127.0.0.1:8848 | | NACOS_USERNAME | 否 | - | Nacos 用户名（需与 NACOS_PASSWORD 同时使用） | | NACOS_PASSWORD | 否 | - | Nacos 密码 | | NACOS_NAMESPACE_ID | 否 | - | 默认命名空间 ID | | NACOS_GROUP | 否 | DEFAULT_GROUP | 默认分组 | | NACOS_ENABLE_WRITE_TOOLS | 否 | false | 是否启用写工具，设为 true 开启 |

使用方式

Claude Code

在 claude_desktop_config.json 或项目 .mcp.json 中配置：

{
  "mcpServers": {
    "nacos": {
      "command": "npx",
      "args": ["nacos-mcp-server"],
      "env": {
        "NACOS_SERVER_URL": "http://devnacos.hanfatong.com:8848",
        "NACOS_USERNAME": "",
        "NACOS_PASSWORD": "",
        "NACOS_NAMESPACE_ID": ""
      }
    }
  }
}

OpenCode

在 opencode.json 中配置：

{
  "mcpServers": {
    "nacos": {
      "command": "npx",
      "args": ["nacos-mcp-server"],
      "env": {
        "NACOS_SERVER_URL": "http://devnacos.hanfatong.com:8848",
        "NACOS_USERNAME": "",
        "NACOS_PASSWORD": "",
        "NACOS_NAMESPACE_ID": ""
      }
    }
  }
}

工具列表

只读工具（默认启用）

| 工具 | 说明 | |------|------| | nacos_get_config | 获取指定配置内容 | | nacos_list_config_history | 列出配置变更历史 | | nacos_get_config_history_detail | 获取配置历史版本详情 | | nacos_list_services | 列出服务列表 | | nacos_get_service | 获取服务详情 | | nacos_list_instances | 获取服务实例列表 |

写工具（需 NACOS_ENABLE_WRITE_TOOLS=true）

| 工具 | 说明 | |------|------| | nacos_publish_config | 发布或更新配置 | | nacos_delete_config | 删除配置 |

开发

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

# 本地调试
npm run dev

# MCP Inspector 调试
npx @modelcontextprotocol/inspector node dist/index.js

兼容性

• Nacos 2.x（优先兼容 2.4.3）
• 不引入 Nacos 专用 SDK，直接封装 /nacos/v1/ HTTP OpenAPI

License

MIT