testlink-mcp

一个对 AI 友好、安全至上的 Model Context Protocol 服务器，适用于 TestLink 1.9.20。它通过 stdio 提供规范化的发现与分析工具、有界游标分页、结构化输出以及先预览后应用的写入操作。

本仓库是基于 TestLink 的公共 XML-RPC 接口和公共 MCP SDK 的干净实现。它不依赖任何私有 TestLink 包或私有源代码树。

亮点

• 无需凭据即可启动，因此 MCP 客户端可以发现所有工具、资源和提示词。

• 提供明确的确定性演示模式，用于评估和上手。

• structuredContent、outputSchema、工具注解、游标分页和稳定的错误码。

• 仅提供附件元数据；附件内容和 base64 载荷已被移除。

• 默认禁用写入。没有删除工具。

• 每次应用都需要 confirm: true、未过期的 10 分钟预览以及未更改的服务器快照。

• 副作用调用永远不会自动重试；应用尝试会写入经过脱敏的操作账本。

• 运行时防护会阻止不受支持/已停止维护的奇数 Node 版本以及低于声明最低安全补丁级别的版本。

Related MCP server: TestRail MCP Server

要求

• Node.js ^22.23.2 || ^24.18.1 || ^26.5.1

• TestLink 1.9.20，并启用其 XML-RPC API

开发和容器基线为 Node 24.19.0 LTS。CI 还运行 Node 22.23.2 和 26.7.0。

快速开始

nvm use
npm ci
npm run build
TESTLINK_DEMO_MODE=true node dist/cli.js

发布后的未来 npm 调用：

npx -y testlink-mcp@1.0.0

MCP 客户端配置：

{
  "mcpServers": {
    "testlink": {
      "command": "npx",
      "args": ["-y", "testlink-mcp@1.0.0"],
      "env": {
        "TESTLINK_URL": "https://testlink.example.com/testlink",
        "TESTLINK_DEV_KEY": "your-testlink-dev-key"
      }
    }
  }
}

不要将真实凭据放入受跟踪的文件中。将 .env.example 复制到被忽略的 .env，或从你的 MCP 客户端/密钥管理器中注入环境变量。

工具

所有工具均返回：

{
  "ok": true,
  "data": {},
  "meta": {
    "source": "testlink",
    "requestId": "..."
  }
}

失败时使用 ok: false 并附带 { code, message, retryable, details? }。使用者应依据 error.code 进行分支判断，而不是消息文本。

安全写入工作流

1. 搜索现有用例并检索其当前版本。

2. 验证所需的测试用例。

3. 调用相关的预览工具。

4. 向用户展示 proposedChanges 并获得明确确认。

5. 在 10 分钟内使用预览 ID 和 confirm: true 调用 apply。

6. 如果 apply 返回 CONFLICT 或 PREVIEW_EXPIRED，请创建并审查新的预览。

仅应在应执行写入的服务器进程中启用写入：

TESTLINK_WRITE_ENABLED=true npx -y testlink-mcp@1.0.0

默认账本路径为 ~/.local/state/testlink-mcp/operations.jsonl。可使用 TESTLINK_LEDGER_PATH 覆盖。账本包含哈希和脱敏结果，不包含开发者密钥。

配置

演示模式是明确的，并且优先于远程配置：

TESTLINK_DEMO_MODE=true TESTLINK_WRITE_ENABLED=true node dist/cli.js

开发

npm ci
npm run check
npm test
npm run eval
npm run build
npm audit --omit=dev --audit-level=high
npm pack --dry-run

离线工具选择评估会检查常见用户意图是否能够明确区分搜索、验证、预览和应用工具。它是确定性的，不会向外部模型发送数据。

Docker

该镜像以非 root 用户运行，并使用 Node 24.19.0。构建但不推送：

docker buildx build --platform linux/amd64,linux/arm64 --tag testlink-mcp:local --output type=oci,dest=testlink-mcp.oci.tar .

批准并发布后的未来镜像名称：ghcr.io/easonlin/testlink-mcp:1.0.0。

发布策略

版本 1.0.0 已具备发布条件，但发布仍是一项明确的操作。受保护的发布工作流要求签名版本标签，重新运行完整的测试/评估/审计/SBOM/包门禁，使用来源证明发布 npm，发布带有 SBOM 和来源证明的多架构 GHCR 镜像，创建 GitHub Release，最后发布已验证的 MCP Registry 条目。

另一个受保护的实时冒烟工作流使用只读调用，针对真实的 TestLink 1.9.20 实例验证已安装的包。其 URL 和开发者密钥必须作为环境机密存储，并且绝不会写入日志。

包清单和 server.json 共享 MCP 名称 io.github.easonlin/testlink-mcp。无需发布即可运行 Registry 验证：

mcp-publisher validate server.json

公开参考

• TestLink 1.9.20 源代码和发布分支

• Model Context Protocol TypeScript SDK

• 官方 MCP Registry 发布者命令

许可证

MIT