# Nacos Mcp Server

> 一款与 Nacos交互和自动化而设计的 MCP Server。它允许用户使用大模型搜索和读取 Nacos 集群中与命名空间、服务、配置和节点相关的信息。

- **Type:** MCP server
- **Install:** `agentstack add mcp-bubua12-nacos-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bubua12](https://agentstack.voostack.com/s/bubua12)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bubua12](https://github.com/bubua12)
- **Source:** https://github.com/bubua12/nacos-mcp-server

## Install

```sh
agentstack add mcp-bubua12-nacos-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🍵 Nacos MCP Server

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

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

---

## ✨ 功能特性

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

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

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

---

## 🏗️ 架构设计

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

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

---

## 🚀 快速开始

### 环境要求

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

### 安装部署

1. **克隆项目**
   ```bash
   git clone https://github.com/your-username/nacos-mcp-server.git
   cd nacos-mcp-server
   ```

2. **配置 Nacos 连接**
   
   编辑 `src/main/resources/application.yaml`:
   ```yaml
   nacos:
     server: http://your-nacos-server:8848
     username: [your-nacos-username]
     password: [your-nacos-password]
   ```

3. **构建和运行**
   ```bash
   mvn clean install
   mvn spring-boot:run
   ```

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

   MCP连接配置：
   ```json
   {
     "mcpServers": {
       "nacos-mcp-server": {
         "url": "http://192.168.31.127:8080/sse",
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   ```

5. **Docker部署**
```yaml
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"
```

---

## ⚙️ 配置说明

### 应用配置

```yaml
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_SERVER` | Nacos 服务器地址 | `http://localhost:8848` |
| `NACOS_USERNAME` | Nacos 用户名   | `nacos` |
| `NACOS_PASSWORD` | Nacos 密码    | `nacos` |
| `APP_LOG_LEVEL` | 日志级别        | `INFO` |
| `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` 进行参数文档化

示例：
```java
@Tool(description = "根据名称获取服务详情")
public Mono 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 许可证 - 详细信息请查看 [LICENSE](LICENSE) 文件。

---

## 🙏 致谢

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

---

## 📞 技术支持

- 📧 **邮箱**: wangty334752@gmail.com
- 🐛 **问题反馈**: [GitHub Issues](https://github.com/your-username/nacos-mcp-server/issues)
- 💬 **讨论交流**: [GitHub Discussions](https://github.com/your-username/nacos-mcp-server/discussions)

---

**⭐ 如果这个项目对您有帮助，请给个 Star！**

由 [bubua12](https://github.com/bubua12) 制作

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bubua12](https://github.com/bubua12)
- **Source:** [bubua12/nacos-mcp-server](https://github.com/bubua12/nacos-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bubua12-nacos-mcp-server
- Seller: https://agentstack.voostack.com/s/bubua12
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.