Jewei Mcp Nacos
About
It is an MCP server that allows AI assistants to query and manage Nacos configurations. It supports Nacos versions 1.x, 2.x, and 3.x.
Details
- Author
- jeweis
- Downloads
- 363
- Categories
- Other
Jump to
- Query and manage Nacos configurations via AI
- Supports Nacos 1.x, 2.x, and 3.x
- Provides get and publish config tools
- Read-only mode for production safety
- Configurable via environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Jewei Mcp NacosCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via uvx jewei-mcp-nacos and configure with environment variables (NACOS_HOST, NACOS_API_PORT, NACOS_CONSOLE_PORT, NACOS_USERNAME, NACOS_PASSWORD, NACOS_NAMESPACE, NACOS_VERSION, NACOS_READ_ONLY) in the appropriate JSON config file for your client (Claude, Cursor, OpenCode, etc.).
nacos_get_config
获取 Nacos 配置内容。 从 Nacos 配置中心获取指定的配置内容。 参数： params: 包含以下内容的验证输入参数： - data_id: 配置 ID - group_name: 配置分组，默认 DEFAULT_GROUP - namespace_id: 命名空间 ID，可选 - response_format: 输出格式，markdown 或 json 返回： 配置内容（Markdown 或 JSON 格式）
nacos_publish_config
发布 Nacos 配置。 创建新配置或更新已有配置。 参数： params: 包含以下内容的验证输入参数： - data_id: 配置 ID - group_name: 配置分组，默认 DEFAULT_GROUP - namespace_id: 命名空间 ID，可选 - content: 配置内容 - config_type: 配置类型，默认 yaml - desc: 配置描述，可选 返回： 发布结果
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"jewei mcp nacos": {
"nacos": {
"command": "uvx",
"args": [
"jewei-mcp-nacos"
],
"env": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_USERNAME": "nacos",
"NACOS_PASSWORD": "your-password",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}
}
}McpServers
{
"nacos": {
"command": "uvx",
"args": [
"jewei-mcp-nacos"
],
"env": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_USERNAME": "nacos",
"NACOS_PASSWORD": "your-password",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}jewei-mcp-nacos
Nacos MCP Server - 让 AI 助手能够查询和管理 Nacos 配置。 支持 Nacos 1.x/2.x/3.x 版本。快速开始
Claude Code
在项目.mcp.json 或全局 ~/.claude.json 中添加：
``json
{
"mcpServers": {
"nacos": {
"type": "stdio",
"command": "uvx",
"args": ["jewei-mcp-nacos"],
"env": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_USERNAME": "nacos",
"NACOS_PASSWORD": "your-password",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}
}
`
Cursor
在 ~/.cursor/mcp.json 中添加：
`json
{
"mcpServers": {
"nacos": {
"command": "uvx",
"args": ["jewei-mcp-nacos"],
"env": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}
}
`
OpenCode
在 ~/.opencode/opencode.json 中添加：
`json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"nacos": {
"type": "local",
"command": ["uvx", "jewei-mcp-nacos"],
"enabled": true,
"environment": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}
}
`
Claude Desktop
在 claude_desktop_config.json 中添加：
`json
{
"mcpServers": {
"nacos": {
"command": "uvx",
"args": ["jewei-mcp-nacos"],
"env": {
"NACOS_HOST": "localhost",
"NACOS_API_PORT": "8848",
"NACOS_CONSOLE_PORT": "8080",
"NACOS_USERNAME": "nacos",
"NACOS_PASSWORD": "your-password",
"NACOS_NAMESPACE": "dev",
"NACOS_VERSION": "3",
"NACOS_READ_ONLY": "false"
}
}
}
}
`
环境变量
| 变量 | 说明 | 默认值 |
|------|------|--------|
| NACOS_HOST | Nacos 服务地址 | localhost |
| NACOS_PORT | API 端口（仅 v1/v2 使用，v1/v2 必填） | 8848 |
| NACOS_API_PORT | API 端口（用于登录，仅 v3 使用，v3 必填） | 8848 |
| NACOS_CONSOLE_PORT | Console 端口（用于配置操作，仅 v3 使用，v3 必填） | 8080 |
| NACOS_USERNAME | 用户名（可选） | - |
| NACOS_PASSWORD | 密码（可选） | - |
| NACOS_NAMESPACE | 默认命名空间 ID（当 NACOS_VERSION=1 时表示 Nacos 的命名空间 ID 字段） | public |
| NACOS_VERSION | Nacos 版本（1/2/3），默认 3 | 3 |
| NACOS_READ_ONLY | 只读模式，禁用发布功能 | false |
可用工具
| 工具 | 说明 |
|------|------|
| nacos_get_config | 获取配置内容 |
| nacos_publish_config | 发布/更新配置（只读模式下不可用） |
提示示例
配置好后，你可以这样和 AI 对话：
查询配置：
`
帮我获取 Nacos 中 dataId 为 "application.yaml" 的配置
`
`
查看 nacos 里 user-service.yml 的配置内容，namespace 是 dev
`
`
获取 gateway 的配置，分组是 PROD_GROUP
`
发布配置：
`
把下面这段配置发布到 Nacos，dataId 是 "redis.yaml"：
server:
port: 6379
`
`
更新 user-service 的配置，把数据库端口改成 3307
`
只读模式
设置 NACOS_READ_ONLY=true 可以禁用发布功能，只允许查询配置。适合生产环境使用。
`json
{
"env": {
"NACOS_READ_ONLY": "true"
}
}
``
License
MITSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
