jewei-mcp-nacos

Nacos MCP Server - 让 AI 助手能够查询和管理 Nacos 配置。

支持 Nacos 1.x/2.x/3.x 版本。

快速开始

Claude Code

在项目 .mcp.json 或全局 ~/.claude.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 中添加：

{
  "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 中添加：

{
  "$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 中添加：

{
  "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 可以禁用发布功能，只允许查询配置。适合生产环境使用。

{
  "env": {
    "NACOS_READ_ONLY": "true"
  }
}

License

MIT

Project links

Data verified by PyPI on Jan 18, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Jewei from gravatar.com Jewei

Credits

Author: Jeweis

GitHub Statistics

Data verified by PyPI on Jan 18, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

configuration mcp model-context-protocol nacos

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jewei_mcp_nacos-0.1.8.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jewei_mcp_nacos-0.1.8-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file jewei_mcp_nacos-0.1.8.tar.gz.

File metadata

  • Download URL: jewei_mcp_nacos-0.1.8.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jewei_mcp_nacos-0.1.8.tar.gz
Algorithm Hash digest
SHA256 60ac2e1d8d4275e810e77dbb19576b3a7bf8295c281234053b010622c2cb3f35
MD5 d9e44b6d4eedb109eaaf4e63eaa1e7d3
BLAKE2b-256 9777544d4002c6215c8ea805abe384cc9c59c3e05e7c8ae8ecc1bc01cafaa8da

See more details on using hashes here.

Provenance

The following attestation bundles were made for jewei_mcp_nacos-0.1.8.tar.gz:

Publisher: publish.yml on jeweis/jewei-mcp-nacos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jewei_mcp_nacos-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for jewei_mcp_nacos-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 b423ed5318b2d25e6ec2006e3d08c430ad30e6ccb7c0c9dc9776fc91e2f6e5f5
MD5 1c3367d41d002e2a25f41c9c20b4da82
BLAKE2b-256 042b985870555a65b263546475d7e8edec77924b40306e79880e9083af9e63de

See more details on using hashes here.

Provenance

The following attestation bundles were made for jewei_mcp_nacos-0.1.8-py3-none-any.whl:

Publisher: publish.yml on jeweis/jewei-mcp-nacos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.2

2 files

0.1.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page