@m00nsolutions/mcp-server

基于 MCP 的智能体测试管理。这个服务器让 AI 助手真正去做事，而不是仅仅阅读相关内容：编写测试用例、规划和填充手动测试执行、将自动化关联回它所覆盖的用例、发布版本，并在 M00N Report 中查看项目健康状况。M00N Report 是一个 AI 原生的测试管理平台。

我需要哪种安装方式？

如果你不是从 claude.ai 或 claude.com 连接，请将此包与 MCP 密钥一起使用。这也是本 README 的其余内容。关于连接器，请参阅连接器指南。

Related MCP server: @testneo/mcp-server

需求

Node 20 或更高版本，以及任何支持 MCP 的客户端。

安装

无需安装步骤。客户端会按照下方配置使用 npx 启动它。

若要在共享或 CI 环境中固定版本，请在 args 中的包名后追加版本号，例如 ["-y", "@m00nsolutions/mcp-server@<version>"]。npm view @m00nsolutions/mcp-server versions 会列出已发布的版本。此处特意使用占位符而非具体数字：这里给出具体示例会在下次发布时过时，而过时的示例会建议你固定到一个已不再包含当前修复的版本。

快速开始

1. 获取 MCP 密钥

在 M00N Report 中，打开 Settings -> MCP Keys 并创建一个密钥。它的格式是 m00n_mcp_ 后跟 48 个十六进制字符。这不是测试报告器使用的凭据；测试报告器的密钥以 m00n_ 开头，在这里会被拒绝。

MCP 密钥的权限恰好与其所属账户的权限一致，绝不会超出，并且可以进一步限定范围。缩小密钥范围会从客户端看到的工具列表中移除相应工具，因此你看到的工具列表比预期短是范围限定的结果，而不是故障。

该密钥应放在你机器上的 MCP 客户端配置中。不要把它放在存放在 GitHub 仓库里的工作区文件中。

2. 连接你的客户端

Claude Code，一行配置：

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

其他所有客户端都使用同一个 JSON 块：

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

这个配置块的放置位置：

对于自托管实例，请将 M00N_API_URL 指向你自己的根地址，且不要包含 /api 后缀。尾部的斜杠会被自动去除。

3. 确认连接

重启客户端，然后询问：

列出我的 M00N Report 项目

如果你看到了项目列表，说明服务器已连接且密钥有效。如果出现错误，或者助手表示没有此类工具，则说明连接失败；请参阅故障排查。

工具

共八个领域。包含完整参数列表的文档位于/documentation/mcp/tools，与代码同步维护。服务器在启动时会从你的实例获取自身的工具清单，因此你的客户端所看到的，正是你的实例在客户端连接时支持的工具。

一次执行就是一次手动测试运行：分配对象、环境、日期，以及基于每个用例在加入那一刻的快照所记录的逐步结果。

你的密钥能看到多少种工具，取决于你的实例：

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

在 m00nreport.com 上使用未限定范围的密钥，于 2026-08-22 返回了 57 个工具。

提示词

客户端可按名称调用的、有引导的多步骤工作流。每个工作流接受一个可选的 project 参数，参数可以是名称或 UUID；省略它时，如果当前上下文中只有一个项目，服务器会自动选中该项目。

资源

客户端无需调用工具即可获取的只读视图：所有项目、项目健康摘要、flaky 测试报告、当前失败的测试、文件夹结构、启动报告、测试用例内容、发布摘要。

配置

两个布尔变量的开启值包括 true、1 或 yes，不区分大小写。任何其他值，包括 false 和 0，都会使它们保持关闭。

前两个变量要么都设置，要么都不设置。只设置其中一个会被视为错误并被拒绝，因为一个半配置却在启动的服务器比一个完全不启动的服务器更难诊断。

这里的基地址是 M00N_API_URL；测试报告器插件把同一个 URL 称为 M00N_SERVER_URL。所有六个包都读取 M00N_API_KEY，但报告器的密钥是可项目的 API 密钥，而不是 MCP 密钥，因此一个导出的 shell 变量不能同时用于两者。

无密钥运行

如果既未设置 M00N_API_URL 也未设置 M00N_API_KEY 就启动，服务器会以预览模式运行：它会从打包的快照中列出自己的工具、提示词和资源，并且不会调用任何工具，而是返回一条消息告诉你需要设置什么。不会向任何地方发送任何数据，因为根本没有目的地。

正是这一点，让检查器、客户端或目录服务能够在有人注册之前展示工具表面。它只是对服务器的描述，而不是一个可用的服务器，因此列表来自快照，而不是来自你的实例：一个范围受限的密钥通常看到的工具会比快照显示的更少。

维护人员使用一个未设置范围的密钥，通过 npm run snapshot:refresh 来刷新快照。

自托管实现

将 M00N_API_URL 指向你自己的实例，并从该实例颁发 MCP 密钥。其他一切完全相同，这在你选择自托管的原因是需要测试数据不能离开自己网络的情况下非常重要。

如果你使用自签名证书，请在同一个 env 块中添加 "M00N_INSECURE_SSL": "true"。完整说明：/documentation/mcp/self-hosted。

发送什么

通过 HTTPS 将你的助手发出的工具调用及其参数发送到 M00N_API_URL。这个服务器你实例的代理，本身不存储任何数据。

每次工具调用都会以 MCP 审计日志形式被写入，日志有应用内的界面，并且按密钥进行速率限制，以避免失控的智能体。密钥永远不会写入该日志，也不会写入 stderr。启用 M00N_DEBUG 后，所有工具调用的参数都会打印到 stderr 上，所以请像对待数据本身一样对待该输出。

故障排查

无论是否设置 M00N_DEBUG，服务器都会向 stderr 记录日志，大多数客户端会在其 MCP 面板中显示这些日志。将 M00N_DEBUG 设置为 true 可以额外记录每个请求及其参数。

Known Limitations

• 工具列表仅在启动时读取一次。 如果你改变了密钥的权限范围或升级实例，客户端会一直保留旧列表，直到你重启客户端。

• 配置后必须能访问 GET /api/health。 它会被最先检查，而一旦失败服务器就会停止，因此如果代理仅转发 /api/mcp/*，客户端不会显示任何工具，即使所有工具本来可以正常工作。

• 权限范围内没有任何工具的键不会启动。 这种情况下服务器会直接退出，而不会用空列表连接。当配置了该环境的方式时将出现此情况；如果完全没有凭据，它反而会以预览模式启动。

• Prompts 和 Resources 是可选的。 如果它们的列表获取失败，服务器仍会启动，并输出错误原因到 stderr，而在整个会话中客户端不会看到其中任何一项。

• 重定向将被拒绝而不会跟随。 密钥放在自定义 header 中，而跟随重定向的实现通常会识别并剥离，最终只会处理它认识的认证 header，因此一旦跟随重定向，便可能把密钥交给我们指向的那个主机。重定向会带着它指向地址被报告出来。

• 仅支持stdio。 如果要使用 HTTP 传输，请使用托管的连接器。

支持

• npm 上的软件包

• 文档

• 报告问题

• 社区 Discord

License

MIT 许可证。请参见 LICENSE。