bubua12/nacos-mcp-server

🍵 Nacos MCP Server

专为与 Nacos 集群无缝交互和自动化而设计的强大 MCP（模型上下文协议）服务器

赋能大模型搜索、读取和管理 Nacos 资源，包括命名空间、服务、配置和集群节点。

✨ 功能特性

📝 配置管理

• 🗂️ 命名空间列表 - 列出所有可用的命名空间
• 🌐 命名空间详情 - 列出命名空间具体的详细信息
• 📋 配置列表 - 查看指定命名空间下的所有配置
• 🔍 配置详情 - 查看指定配置的详细信息
• 🔎 获取配置历史 - 查看指定配置的历史配置信息

🎯 服务管理

• 📡 服务发现 - 列出指定命名空间下的在线服务
• 🔍 服务实例 - 查询指定服务的实例列表
• 📊 服务详情 - 查看服务信息详情
• 🌐 服务上下线 - 对服务实例进行上线或者下线

🖥️ 节点管理

• 🏗️ 集群状态 - 实时集群节点状态监控、系统当前数据指标
• 📈 健康检查 - 查询当前节点健康状态
• 🔧 节点信息 - 详细的节点元数据和配置
• ⚡ 客户端信息查看 - 查询客户端列表及具体的客户端信息

🏗️ 架构设计

本项目基于 Spring AI MCP Server，提供：

• 🤖 AI 集成 - 内置大型语言模型交互支持
• 🔧 工具化设计 - 模块化工具系统，功能可扩展

🚀 快速开始

环境要求

• ☕ Java 21 或更高版本
• 🐳 Nacos Server (推荐 2.4.3+ 版本)
• 🛠️ Maven 3.6+

安装部署

1. 克隆项目

   git clone https://github.com/your-username/nacos-mcp-server.git
   cd nacos-mcp-server
   

2. 配置 Nacos 连接

   编辑 src/main/resources/application.yaml:

   nacos:
     server: http://your-nacos-server:8848
     username: [your-nacos-username]
     password: [your-nacos-password]
   

3. 构建和运行

   mvn clean install
   mvn spring-boot:run
   

4. 访问 MCP 服务器

   服务器将在默认端口启动，SSE 端点地址为 /sse，mcp client连接完整地址为：IP:8080/sse

   MCP连接配置：

   {
     "mcpServers": {
       "nacos-mcp-server": {
         "url": "http://192.168.31.127:8080/sse",
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

5. Docker部署

version: '3.9'

services:
  nacos-mcp-server:
    image: bubua12/nacos-mcp-server:v2.4.3
    container_name: nacos-mcp-server
    restart: always
    ports:
      - "8080:8080"
    environment:
      NACOS_SERVER: "http://your-nacos-server:8848"
      NACOS_USERNAME: "your-nacos-username"
      NACOS_PASSWORD: "your-nacos-password"
      APP_LOG_LEVEL: "DEBUG"
      HTTP_LOG_LEVEL: "INFO"
      JAVA_OPTS: "-Xms512m -Xmx1024m"

⚙️ 配置说明

应用配置

spring:
  application:
    name: nacos-mcp-server
  main:
    banner-mode: off
  ai:
    mcp:
      server:
        name: nacos-mcp-server
        version: v2.4.3
        sse-endpoint: /sse
        instructions: "Nacos MCP AI Tools - 提供Nacos集群管理的AI工具"

nacos:
  server: ${NACOS_SERVER:http://192.168.1.242:8848}
  username: ${NACOS_USERNAME:nacos}
  password: ${NACOS_PASSWORD:nacos}

logging:
  level:
    com.bubua12.mcp.nacos: ${APP_LOG_LEVEL:INFO}
    org.springframework.web.reactive.function.client: ${HTTP_LOG_LEVEL:INFO}

环境变量

🏢 项目结构

nacos-mcp-server/
├── src/main/java/com/bubua12/mcp/nacos/
│   ├── config/
│   │   └── ToosConfig.java              # 工具配置
│   ├── service/
│   │   └── NacosMetaService.java        # 核心 Nacos 操作
│   └── NacosWebfluxMCPServerApplication.java  # 主应用程序
├── src/main/resources/
│   └── application.yaml                 # 应用配置
└── pom.xml                             # Maven 依赖

🔧 开发指南

添加新工具

1. 在 NacosMetaService 中创建新方法
2. 使用 @Tool 注解并提供描述
3. 使用 @ToolParam 进行参数文档化

示例：

@Tool(description = "根据名称获取服务详情")
public Mono<String> getServiceDetails(
    @ToolParam(description = "服务名称") String serviceName,
    @ToolParam(description = "命名空间 ID") String namespace) {
    // 实现代码
}

🤝 贡献指南

1. Fork 本仓库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

本项目基于 MIT 许可证 - 详细信息请查看 文件。

🙏 致谢

• Nacos 社区 - 提供优秀的服务发现和配置管理平台
• Spring AI 团队 - 提供创新的 MCP Server 框架
• 阿里云 - 提供强大的 Nacos 生态系统

📞 技术支持

• 📧 邮箱: wangty334752@gmail.com
• 🐛 问题反馈: GitHub Issues
• 💬 讨论交流: GitHub Discussions