适合谁
- 已在 Kubernetes 上运行 Testkube 并使用自动化测试的工程团队
- 希望用 AI 助手管理测试工作流与执行记录的平台/DevOps 团队
- 需要把测试结果查询和故障排查整合进 AI 工作流的组织
T
63FMRS · C
Testkube MCP Server 是 Testkube 官方提供的 MCP 接入点，面向在 Kubernetes 上运行自动化测试的 AI 驱动工程团队，覆盖测试工作流、执行记录与产物的管理。它同时支持本地 stdio 运行的 OCI 镜像和托管 streamable-http 远程端点，接入权限依赖 Testkube 访问令牌及组织/环境凭据，官方文档为 https://docs.testkube.io/articles/mcp-overview。来源未列出具体工具名称，因此工具清单为空。
Testkube MCP Server 由 Testkube 官方维护，让 AI 助手能够管理 Testkube 的测试工作流、执行记录与产物。它提供两种接入方式：一种是在本地以 stdio 运行的 OCI 镜像 docker.io/kubeshop/mcp-server:latest，另一种是托管在 https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp 的 streamable-http 远程端点。远程端点需要提供 organization_id（如 tkcorg_xxxxxxx）和 environment_id（如 tkcenv_xxxxxxx）。本地镜像需要 TK_ACCESS_TOKEN、TK_ORG_ID、TK_ENV_ID 三个必填环境变量，并可选配置 TK_CONTROL_PLANE_URL、TK_DASHBOARD_URL、TK_DEBUG、TK_MCP_TRANSPORT、TK_MCP_SHTTP_HOST、TK_MCP_SHTTP_PORT。该服务器适用于使用 Kubernetes 运行自动化测试、并希望通过 AI 助手触发测试、查看执行结果和产物、进行故障排查的团队；不适合没有 Testkube 组织/环境或不愿将测试访问令牌交给 AI 客户端的用户。
安装接入
- 在 Testkube 控制台获取访问令牌、组织 ID（tkcorg_xxxxxxx）和环境 ID（tkcenv_xxxxxxx）。
- 若使用本地 stdio 方式：在 MCP 客户端中配置运行 OCI 镜像 docker.io/kubeshop/mcp-server:latest，并设置必填环境变量 TK_ACCESS_TOKEN、TK_ORG_ID、TK_ENV_ID；按需设置 TK_CONTROL_PLANE_URL（默认 https://api.testkube.io）、TK_DASHBOARD_URL、TK_DEBUG、TK_MCP_TRANSPORT（stdio 或 shttp，默认 stdio）、TK_MCP_SHTTP_HOST、TK_MCP_SHTTP_PORT。
- 若使用远程方式：在客户端中直接连接 streamable-http 端点 https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp，并把 organization_id 与 environment_id 替换为真实值。
- 具体客户端配置格式请以官方文档 https://docs.testkube.io/articles/mcp-overview 为准。
选型与风险
不适合谁
- 尚未部署 Testkube 或没有组织/环境凭据的用户
- 不希望将测试访问令牌暴露给 AI 客户端的团队
- 与 Testkube 无关的通用测试或非 Kubernetes 测试场景
所需权限
- 读取并使用 Testkube 访问令牌（TK_ACCESS_TOKEN）进行身份验证
- 访问指定 Testkube 组织与环境范围内的测试工作流、执行记录和产物
- 远程模式需要能够访问 https://api.testkube.io 以及对应组织与环境路径
风险与副作用
- 访问令牌为敏感凭据，一旦泄露可能允许他人读取或操作被测组织/环境内的测试数据
- AI 助手可能触发或影响真实测试执行，进而影响 Kubernetes 集群中的测试资源
- 远程 streamable-http 模式会把请求与凭据发送到 Testkube 云端控制平面
- 若令牌权限过大或组织/环境 ID 配置错误，可能访问到预期之外的环境
常见排障
- 确认 TK_ACCESS_TOKEN、TK_ORG_ID、TK_ENV_ID 均已正确设置且非空
- 确认 organization_id 与 environment_id 与 Testkube 控制台中的值一致（tkcorg_ 与 tkcenv_ 前缀）
- 远程模式无法连接时，检查网络是否能访问 https://api.testkube.io；本地模式检查使用的控制平面 URL（默认 https://api.testkube.io）
- 启用 TK_DEBUG 以获得更详细的调试输出
- 使用 shttp 传输时，检查 TK_MCP_TRANSPORT、TK_MCP_SHTTP_HOST、TK_MCP_SHTTP_PORT 的取值是否匹配
使用场景
通过 AI 助手触发和查看 Testkube 测试工作流的执行情况
查询测试执行结果、日志与产物以便集中排查问题
在 Kubernetes 环境中把测试编排接入 AI 驱动的日常研发流程
为 CI/CD 与 GitOps 场景中的测试结果提供自然语言查询入口
支持客户端
Claude Desktop部分支持