Skip to main content
Glama
Verkaka

nacos-config-mcp

by Verkaka

nacos-config-mcp

一个只读Model Context Protocol (MCP) 服务器,用于读取 Nacos 配置中心里的配置,同时兼容 Nacos 1.x / 2.x / 3.x

它把 Nacos 的命名空间、配置检索、配置详情与历史版本能力,通过 6 个只读工具暴露给支持 MCP 的 AI 客户端(Claude Desktop、Cursor、Trae 等),让模型能够安全地查阅你的配置,而永远无法修改它们。

特性

  • 只读:仅使用 GET 请求(POST 仅用于登录换取 token),不提供任何发布、更新、删除配置的能力。

  • 多版本兼容:自动探测 Nacos 大版本,并为每个操作准备有序的端点回退链;探测失败时也能通过回退链自愈。

  • 双传输:默认 stdio,也可切换为 Streamable HTTP(无状态、可选 Bearer Token 鉴权)。

  • 多种鉴权:匿名、Nacos 用户名/密码(1.x/2.x 的 /v1/auth/login、3.x 的 /v3/auth/user/login)、预置 access token、以及 server identity 头。

  • TypeScript + Node:基于官方 @modelcontextprotocol/sdk,Node.js ≥ 18.17,零运行时框架依赖。

  • 日志走 stderr:stdout 完全留给 stdio 的 JSON-RPC 通信。

Related MCP server: jewei-mcp-nacos

版本兼容性

能力

Nacos 1.x

Nacos 2.x

Nacos 3.x

登录

POST /nacos/v1/auth/login

同 1.x

POST /v3/auth/user/login

命名空间列表

/v1/console/namespaces

/v2/console/namespace/list

/v3/console/core/namespace/list

获取配置

/v1/cs/configs(纯文本)

/v2/cs/config(JSON)

/v3/client/cs/config

搜索/列出配置

/v1/cs/configs?search=...

/v2/cs/config/list

/v3/console/cs/config/list

历史列表

/v1/cs/history

/v2/cs/history/list

/v3/console/cs/history/list

版本探测

/v1/console/server/state

同 1.x

/v3/console/server/state

默认命名空间

""

""

"public"

说明:v3 的 Console API 默认监听独立端口(通常 8080)且不带 /nacos 前缀,可通过 NACOS_CONSOLE_URL / NACOS_CONSOLE_CONTEXT_PATH 单独指定。默认命名空间在内部统一归一化为空字符串,"""public" 均会被接受。

安装

npm install
npm run build

构建产物位于 dist/,可通过 npx nacos-config-mcpnode dist/index.js 启动。

配置项

所有配置均可通过命令行参数或环境变量提供(命令行优先)。

命令行

环境变量

说明

默认值

--base-url

NACOS_BASE_URL

Nacos 服务地址,如 http://127.0.0.1:8848

必填

--context-path

NACOS_CONTEXT_PATH

Server 端上下文路径

/nacos

--console-url

NACOS_CONSOLE_URL

Nacos 3.x Console 地址,如 http://127.0.0.1:8080

NACOS_BASE_URL 相同

--console-context-path

NACOS_CONSOLE_CONTEXT_PATH

Console 上下文路径

--version

NACOS_VERSION

强制指定大版本:auto | 1 | 2 | 3

auto

--namespace

NACOS_NAMESPACE

工具未指定命名空间时使用的默认命名空间

空(public)

--timeout

NACOS_TIMEOUT_MS

HTTP 超时(毫秒)

10000

--tls-insecure

NACOS_TLS_INSECURE

跳过 TLS 证书校验

false

--auth-type

NACOS_AUTH_TYPE

none | nacos | bearer

有凭据时 nacos

--username

NACOS_USERNAME

Nacos 用户名

--password

NACOS_PASSWORD

Nacos 密码

--access-token

NACOS_ACCESS_TOKEN

预置 access token

NACOS_SERVER_IDENTITY_KEY

Server identity 头名称

NACOS_SERVER_IDENTITY_VALUE

Server identity 头取值

--transport / --http

MCP_TRANSPORT

stdio | http

stdio

--host

MCP_HTTP_HOST

HTTP 监听地址

127.0.0.1

--port

MCP_HTTP_PORT

HTTP 监听端口

3000

--http-path

MCP_HTTP_PATH

HTTP 端点路径

/mcp

--http-token

MCP_HTTP_TOKEN

HTTP 请求所需的 Bearer Token

不校验

--log-level

NACOS_LOG_LEVEL

debug | info | warn | error | silent

warn

客户端接入

stdio(默认)

Claude Desktop / Cursor / Trae 等客户端配置示例:

{
  "mcpServers": {
    "nacos-config": {
      "command": "npx",
      "args": ["-y", "nacos-config-mcp"],
      "env": {
        "NACOS_BASE_URL": "http://127.0.0.1:8848",
        "NACOS_USERNAME": "nacos",
        "NACOS_PASSWORD": "nacos"
      }
    }
  }
}

使用本地构建产物时:

{
  "mcpServers": {
    "nacos-config": {
      "command": "node",
      "args": ["/absolute/path/to/nacos-config-mcp/dist/index.js"],
      "env": {
        "NACOS_BASE_URL": "http://127.0.0.1:8848"
      }
    }
  }
}

Streamable HTTP

NACOS_BASE_URL=http://127.0.0.1:8848 \
MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_TOKEN=secret \
node dist/index.js

端点:http://127.0.0.1:3000/mcp(无状态模式,仅接受 POST)。设置 MCP_HTTP_TOKEN 后,请求需携带 Authorization: Bearer secret

提供的工具

工具

说明

主要参数

nacos_server_info

报告连接信息:探测到的版本、大版本、实际使用的端点、上下文路径与鉴权方式。排查连通性/版本问题时优先调用。

nacos_list_namespaces

列出命名空间(租户),可按命名空间 ID 过滤。

namespaceId?

nacos_search_configs

搜索/分页浏览配置项,支持精确/模糊匹配与分组、应用名、标签、类型过滤。返回分页摘要(不含内容)。

dataId? group? namespaceId? search? appName? configTags? type? pageNo? pageSize?

nacos_get_config

读取单个配置的完整内容与元数据。

dataId group? namespaceId?

nacos_list_config_history

列出配置的历史修订,返回可传给详情工具的修订 ID(nid)。

dataId group? namespaceId? pageNo? pageSize?

nacos_get_config_history_detail

读取某个历史修订的内容与元数据。

nid dataId group? namespaceId?

所有工具均带有 readOnlyHint: truedestructiveHint: false 注解,单页最多返回 500 条(pageSize 上限)。

只读保证

  • HTTP 客户端只允许 GETPOST 两种方法(client.ts),POST 仅用于登录换取 token。

  • 代码中不存在任何发布、更新、删除配置的端点。

  • 所有工具均标注为只读。

开发

npm run dev        # 以 tsx 直接运行源码
npm run build      # 编译到 dist/
npm run typecheck  # 类型检查(不产出文件)
npm test           # 运行 vitest 单测

目录结构

src/
├── index.ts            # CLI 入口:分发 stdio / http
├── server.ts           # 组装 HttpClient/Auth/Version/Api 与 McpServer
├── config.ts           # 参数与环境变量解析
├── nacos/
│   ├── client.ts       # 只读 HTTP 客户端(超时、重试)
│   ├── auth.ts         # 登录与 token 缓存
│   ├── version.ts      # 大版本探测
│   ├── api.ts          # 多版本兼容 API 层 + 解析器
│   └── types.ts        # 领域类型
├── tools/              # 6 个 MCP 工具
└── util/               # 错误、日志、文本工具

License

MIT

Available Tools

6 tools
nacos_get_configGet Nacos config detailA
Read-onlyIdempotent

Read the full content and metadata of a single configuration entry identified by dataId + group + namespace. Compatible with Nacos 1.x, 2.x and 3.x; on Nacos 1.x the raw text body is returned.

ParametersJSON Schema
NameRequiredDescriptionDefault
groupNoConfiguration group, e.g. DEFAULT_GROUP.
dataIdYesConfiguration data ID, e.g. application.yaml.
namespaceIdNoNamespace (tenant) ID. Omit to use the namespace configured for this server. The default namespace is "" on Nacos 1.x/2.x and "public" on Nacos 3.x; both are accepted.

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds genuinely useful non-obvious behavior: compatibility with Nacos 1.x/2.x/3.x and the raw-text-body return on Nacos 1.x. It does not enumerate every return field, but it goes beyond what the annotations provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with the core read action and identity fields front-loaded, followed by version compatibility and the return-format caveat. Every sentence earns its place and there is no redundant restatement of the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description usefully explains that the tool returns 'full content and metadata' and clarifies the Nacos 1.x raw-body behavior. It does not enumerate metadata fields or error cases, but for a simple config-fetch tool this is reasonably complete for an agent to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the input schema already documents all three parameters, including the namespace default behavior. The description adds the identity relationship ('identified by dataId + group + namespace') and single-entry scope, but it does not materially deepen the meaning of the parameters beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb 'Read' and names the exact resource: 'full content and metadata of a single configuration entry'. It also lists the identifying fields (dataId + group + namespace), which clearly distinguishes this from sibling search/list/history tools that operate over multiple entries or historical versions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrasing 'single configuration entry' and the need for exact identifiers imply this tool is for fetching one known config rather than discovering or browsing configs. However, no sibling tool is named and no explicit when-to-use/when-not-to-use guidance is provided, so the usage context is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

nacos_get_config_history_detailGet Nacos config history detailA
Read-onlyIdempotent

Read the content and metadata of one historical revision of a configuration entry. Use the revision id (nid) returned by nacos_list_config_history. Compatible with Nacos 1.x, 2.x and 3.x.

ParametersJSON Schema
NameRequiredDescriptionDefault
nidYesRevision id of the history entry, from nacos_list_config_history.
groupNoConfiguration group, e.g. DEFAULT_GROUP.
dataIdYesConfiguration data ID, e.g. application.yaml.
namespaceIdNoNamespace (tenant) ID. Omit to use the namespace configured for this server. The default namespace is "" on Nacos 1.x/2.x and "public" on Nacos 3.x; both are accepted.

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds value by clarifying that this reads a historical revision (not current config), that the nid comes from the list tool, and that namespace behavior differs across Nacos versions (default namespace is '' on 1.x/2.x and 'public' on 3.x, both accepted). This is useful behavioral context beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences with no wasted words. The core action and resource are front-loaded, the critical prerequisite (nid from the list tool) is stated immediately, and the compatibility note is a single compact sentence. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only tool with no output schema, the description covers the essential context: what it reads, how to obtain the required nid, and version compatibility. The namespace default behavior is already in the schema. The only minor gap is that it doesn't describe the return format or whether the content is returned raw or parsed, but for a simple read operation with strong annotations and schema coverage, this is adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all four parameters. The description adds the key semantic link that nid is the revision id from nacos_list_config_history, which is valuable. However, it doesn't add much beyond that for group, dataId, or namespaceId, since the schema already provides examples and the namespace default behavior is described in the schema. Baseline 3 is appropriate because the schema carries the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Read'), a specific resource ('content and metadata of one historical revision of a configuration entry'), and explicitly distinguishes it from the sibling list tool by referencing the revision id returned by nacos_list_config_history. This makes the tool's purpose unambiguous and differentiates it from nacos_get_config and nacos_list_config_history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says to use the revision id (nid) returned by nacos_list_config_history, which is a clear prerequisite and usage instruction. It also states compatibility with Nacos 1.x, 2.x, and 3.x, which helps the agent know when this tool is applicable. While it doesn't explicitly name alternatives, the reference to the sibling list tool and the clear 'read one historical revision' scope provides strong usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

nacos_list_config_historyList Nacos config historyA
Read-onlyIdempotent

List the revision history of a configuration entry. Each item carries the revision id (nid) that can be passed to nacos_get_config_history_detail to read that revision. Compatible with Nacos 1.x, 2.x and 3.x.

ParametersJSON Schema
NameRequiredDescriptionDefault
groupNoConfiguration group, e.g. DEFAULT_GROUP.
dataIdYesConfiguration data ID, e.g. application.yaml.
pageNoNo1-based page number, defaults to 1.
pageSizeNoItems per page between 1 and 500, defaults to 20.
namespaceIdNoNamespace (tenant) ID. Omit to use the namespace configured for this server. The default namespace is "" on Nacos 1.x/2.x and "public" on Nacos 3.x; both are accepted.

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false. The description adds useful behavioral context beyond that: the returned items are revision summaries carrying an nid usable for detail retrieval, and the tool is compatible across Nacos 1.x, 2.x, and 3.x. This is meaningful without contradicting the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no wasted words. The primary purpose is front-loaded, the nid-to-detail relationship is stated in one clause, and version compatibility is a compact final addition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only listing tool with five well-documented parameters and clear annotations, the description is mostly complete. It explains the output's key field and the follow-up tool, though with no output schema it could have said slightly more about other returned fields or default ordering.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so the schema already documents every parameter. The tool description adds no new parameter-level detail, which is acceptable under the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action and resource: 'List the revision history of a configuration entry.' It also clarifies the output's role by noting each item carries a revision id (nid), which clearly separates this from current-config tools like nacos_get_config and from search-oriented tools like nacos_search_configs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context by positioning this tool as the listing step whose nid feeds into nacos_get_config_history_detail. It does not explicitly state when to avoid this tool or name alternatives such as nacos_get_config, but the workflow implication is strong and the sibling tool is referenced directly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

nacos_list_namespacesList Nacos namespacesA
Read-onlyIdempotent

List the namespaces (tenants) available on the Nacos server, optionally filtered to a single namespace ID. Works across Nacos 1.x, 2.x and 3.x.

ParametersJSON Schema
NameRequiredDescriptionDefault
namespaceIdNoNamespace (tenant) ID. Omit to use the namespace configured for this server. The default namespace is "" on Nacos 1.x/2.x and "public" on Nacos 3.x; both are accepted.

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds cross-version compatibility and optional filtering, but does not describe return shape, pagination, or error behavior. This is acceptable for a simple read-only list operation but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single well-structured sentence delivers the core purpose, the optional parameter behavior, and version compatibility without any wasted words. Key information is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple read-only listing tool with one optional parameter, the combination of description, schema, and annotations fully supports correct selection and invocation. No critical information about when or how to call the tool is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the namespaceId parameter already includes detail about omitting it and default namespace differences across versions. The description's mention of optional filtering reinforces the schema without adding significant new meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List'), the resource ('namespaces (tenants) available on the Nacos server'), and an optional filtering behavior ('optionally filtered to a single namespace ID'). It is easily distinguished from sibling tools that deal with server info or configs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description makes it obvious when to use the tool: when namespace/tenant information is needed. It does not explicitly name alternatives or exclusions, but the resource-specific phrasing and sibling context make mis-selection unlikely. It also notes cross-version compatibility, which adds useful context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

nacos_search_configsSearch Nacos configsA
Read-onlyIdempotent

Search or page through configuration entries in a namespace. Supports exact and fuzzy matching on dataId, plus filters for group, application name, tags and content type. Returns paged summaries (without content); call nacos_get_config to read a value. Compatible with Nacos 1.x, 2.x and 3.x.

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoFilter by configuration type, e.g. yaml, properties, json.
groupNoConfiguration group, e.g. DEFAULT_GROUP.
dataIdNoData ID pattern to match. Leave empty to list everything in the namespace.
pageNoNo1-based page number, defaults to 1.
searchNoMatching mode for dataId/group: "accurate" (exact) or "blur" (wildcard). Defaults to blur.
appNameNoFilter by the owning application name.
pageSizeNoItems per page between 1 and 500, defaults to 20.
configTagsNoFilter by configuration tags.
namespaceIdNoNamespace (tenant) ID. Omit to use the namespace configured for this server. The default namespace is "" on Nacos 1.x/2.x and "public" on Nacos 3.x; both are accepted.

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, and non-destructive behavior, so the bar is lower. The description adds valuable behavioral context by stating the result is a paged summary without content, and by noting compatibility across Nacos major versions, which informs how results and namespace semantics may vary.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded, starting with the core purpose and then layering matching modes, return behavior, routing guidance, and compatibility. Every sentence adds distinct information without redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description efficiently covers what is returned (paged summaries without content), which is essential caller knowledge. Combined with the fully described 9-parameter schema and annotations, the context is complete enough for an agent to use the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents every parameter individually. The description adds a high-level view of filters and matching modes, but no significant new parameter-level meaning beyond what the schema provides, justifying the baseline score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches and pages through configuration entries in a namespace, with specific filters and matching modes. It also distinguishes itself from nacos_get_config by noting it returns summaries without content, making the tool's role unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear usage context for searching and paging configs, and explicitly directs agents to nacos_get_config when the actual value is needed. It does not, however, contrast itself with the history-related siblings such as nacos_list_config_history, leaving some routing ambiguity for those cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

nacos_server_infoNacos server infoA
Read-onlyIdempotent

Report how this MCP server is connected to Nacos: detected server version, major version, the API endpoints actually in use, context path and authentication mode. Use this first when troubleshooting connectivity or version compatibility.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, and non-destructive behavior, so the description does not need to repeat these. It adds context by specifying exactly what information is reported (version, endpoints, auth mode), which goes beyond annotations and helps the agent understand the tool's output nature.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact—two sentences with no filler. The purpose is front-loaded, followed by the specific data points reported and the usage guidance. Every word adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter diagnostic tool without an output schema, the description fully covers what the agent needs: what the tool does, what details it reports, and when to use it. Nothing essential is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, and the schema coverage is 100% (empty object). Per the baseline for zero-parameter tools, a score of 4 is appropriate. The description doesn't need to explain any parameters since none exist.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool reports how the server is connected to Nacos, enumerating the specific details (version, endpoints, context path, auth mode). This distinguishes it from sibling tools that operate on namespaces or configs, making the intent unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly instructs to use this tool first when troubleshooting connectivity or version compatibility, giving a clear when-to-use directive. While it doesn't name alternatives, the priority and scenario are specific enough to guide selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv0.1.0
    • First observednacos_get_config
    • First observednacos_get_config_history_detail
    • First observednacos_list_config_history
    • First observednacos_list_namespaces
    • First observednacos_search_configs
    • First observednacos_server_info

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation5/5

Each tool targets a distinct action: server info, namespace listing, config search, config content retrieval, and history list/detail. The search tool explicitly returns summaries without content and points to get_config, so there is no functional overlap.

Naming Consistency4/5

All tool names share a consistent nacos_ prefix and mostly follow the verb_noun pattern (list_namespaces, search_configs, get_config, list_config_history). The only deviation is nacos_server_info, which lacks a verb, but this is a minor inconsistency.

Tool Count5/5

Six tools is a well-scoped set for reading Nacos configurations and their history. Each tool has a clear purpose and none feel redundant.

Completeness3/5

The read-side coverage is solid: namespaces, search, content retrieval, and full history review are all present. However, there are no create, update, delete, publish, or remove operations, leaving the configuration lifecycle incomplete.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    A server that enables interaction with Nacos service discovery and configuration management through Large Language Models, providing read-only access to namespaces, services, and configurations.
    11
    11
    Apache 2.0
  • A
    license
    B
    quality
    D
    maintenance
    An MCP server that enables AI assistants to query and manage Nacos configurations. It supports Nacos 3.x for retrieving or publishing configuration files and includes an optional read-only mode for secure environments.
    2
    3
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server that exposes all AgileConfig RESTful APIs as tools, enabling AI assistants to manage configuration, applications, users, nodes, and more via natural language.
    36
    13 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables AI assistants to query and manage Nacos configurations, supporting Nacos 1.x/2.x/3.x with multiple transport protocols.
    7
    1
    MIT