# mcp

**Repository Path**: IvenKooLab/mcp

## Basic Information

- **Project Name**: mcp
- **Description**: 自研mcp，目前支持nacos2.x版本的mcp，解决官方只兼容3.x版本的问题
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MCP

## README

# nacos2-mcp

[English](README_EN.md) | 简体中文

让 AI 编程助手只读查询 Nacos 2.x 的配置和服务。**纯只读，改不了任何东西。**

> 背景：官方 nacos-mcp-server 只支持 Nacos 3.x，本工具填补 2.x 的空白。

---

## 三步接入

### 第 1 步：安装 uv

Windows 打开 PowerShell，粘贴回车：

```powershell
irm https://astral.sh/uv/install.ps1 | iex
```

macOS / Linux：

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

### 第 2 步：拉包

```bash
git clone https://gitee.com/IvenKooLab/mcp.git
```

记住 `nacos2-mcp` 子目录的本机路径，比如 `D:\mcp\nacos2-mcp`。

### 第 3 步：改 mcp.json

找到你 IDE 的 MCP 配置文件，加入下面的配置（**把路径改成你第 2 步记下的**）：

```jsonc
{
  "mcpServers": {
    "nacos2": {
      "command": "C:\\Users\\你的用户名\\.local\\bin\\uvx.exe",
      "args": [
        "--from",
        "D:\\mcp\\nacos2-mcp",
        "nacos2-mcp"
      ],
      "env": {
        "NACOS_ADDR": "http://127.0.0.1:8848/nacos",
        "NACOS_USER": "dev",
        "NACOS_PASS": "dev",
        "NACOS_NS": "test"
      }
    }
  }
}
```

> Windows 下 `command` 建议用 uvx.exe 的绝对路径，避免 IDE 找不到。

### 各 IDE 的配置文件位置

| IDE | 配置文件 |
|---|---|
| ZCode | `~/.zcode/cli/config.json`，顶层用 `mcp.servers` |
| Qoder | `%APPDATA%\Qoder\SharedClientCache\extension\local\mcp.json` |
| Cursor | `<repo>/.cursor/mcp.json` |
| Claude Desktop | `claude_desktop_config.json` |
| VS Code | `<repo>/.vscode/mcp.json`，顶层用 `servers` |

改完重启 IDE 即可。

---

## 验证

在 AI 对话框里问一句：

> 查一下 test 命名空间 MEMBER_GROUP 组下有哪些配置

如果返回配置列表，说明接入成功。

---

## 五个工具（全部只读）

| 工具 | 作用 |
|---|---|
| `list_namespaces` | 列出命名空间（名字→id 映射，查环境先调它） |
| `get_config` | 读一条配置的完整内容 |
| `search_configs` | 搜索/列出配置 |
| `list_services` | 列出已注册的服务 |
| `get_instances` | 看某服务的实例 |

查不同环境的配置，在对话里说 `namespace`（如 `test` / `uat` / `prod`）即可，不用改配置。

## 与其他方案对比

| | 本工具 | 官方 nacos-mcp-server | jeweis/jewei-mcp-nacos |
|---|---|---|---|
| Nacos 2.x | ✅（v1 Open API） | ❌ 要求 ≥ 3.0 | ✅ |
| Nacos 3.x | 未测试（主打 2.x） | ✅ | ✅ |
| 服务发现（服务/实例） | ✅ | ✅ | ❌ 仅配置 |
| 只读保证 | ✅ 纯只读 | ✅ | 需设 `NACOS_READ_ONLY=true`，默认可写 |
| 维护状态 | 活跃 | 早期开发 | 停更（2026-01 起无更新） |

> 官方生态（nacos-mcp-server / MCP Router / MCP Registry）围绕 Nacos 3.x 构建，
> 依赖 3.x 才有的 Admin API；存量 2.x 集群正是本工具存在的理由。

## 开发与测试

```bash
pip install "mcp>=1.2.0,<2" httpx pyyaml pytest
PYTHONPATH=src python -m pytest tests -q   # 5 个离线测试，无需 Nacos
```