Metadata-Version: 2.4
Name: nacos-mcp-py
Version: 0.2.0
Summary: 基于 nacos-sdk-python 的 Nacos MCP Server，支持多环境配置读取与 Spring Cloud 项目配置发现
Author: dong_tech
License: MIT
Keywords: ai,config,llm,mcp,model-context-protocol,nacos,spring-cloud
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: nacos-sdk-python<3.0.0,>=2.0.11
Description-Content-Type: text/markdown

# nacos-mcp-py

基于 nacos-sdk-python 的 Nacos MCP Server，支持多环境配置读取与 Spring Cloud 项目配置发现。

## 功能

- `nacos_get_config` — 按 dataId + group 读取配置内容
- `nacos_list_configs` — 按 group 列出配置列表
- `nacos_discover_configs` — 扫描 Spring Cloud 项目配置文件，自动发现并读取 Nacos 配置
- `nacos_list_environments` — 查看已配置的环境列表

## 安装

```bash
pip install nacos-mcp-py
# 或
uv tool install nacos-mcp-py
```

## 配置

通过环境变量 `NACOS_SERVERS` 配置多环境 Nacos 连接：

```bash
export NACOS_SERVERS='{
  "test": {
    "host": "mse-xxx.mse.aliyuncs.com",
    "port": 8848,
    "namespace": "ns-id",
    "accessKey": "your-ak",
    "secretKey": "your-sk"
  }
}'
```

## 使用

作为 MCP Server 运行：

```bash
nacos-mcp-py
```

在 Claude Code 的 `~/.claude.json` 中配置：

```json
{
  "mcpServers": {
    "nacos-mcp-py": {
      "command": "nacos-mcp-py",
      "env": {
        "NACOS_SERVERS": "{\"test\": {\"host\": \"...\", \"port\": 8848, \"namespace\": \"...\", \"accessKey\": \"...\", \"secretKey\": \"...\"}}"
      }
    }
  }
}
```

然后在对话中：

- "读取 Nacos 配置 dataId=system.properties group=financeServer"
- "列出 financeServer 分组的所有配置"
- "扫描这个项目目录 /path/to/project 自动发现 Nacos 配置"
