SuperAPI AI 工具集

mcp-qa

智能体与模型

查看项目

更新于 10-15 21:51

技能介绍

用途:在提交或创建 PR 前,端到端验证 MCP 工具行为,优先使用智能体可调用的路径,而非浏览器或 inspector 工作流。

主要能力与流程:

  1. 质量门禁:运行 pnpm run tsc && pnpm run lint && pnpm run test,先修复所有失败。
  2. Stdio CLI(工具行为的主要 QA 路径):先构建 pnpm -w run build;检查认证 pnpm --filter @sentry/mcp-server start auth status,无缓存时执行 pnpm --filter @sentry/mcp-server start auth login。设备码认证使用内置 stdio 公共客户端 ID,无需客户端密钥,与 Cloudflare OAuth 应用分离,令牌缓存于 ~/.sentry/mcp.json。随后验证启动与认证:pnpm -w run cli --transport stdio --list-tools 和 pnpm -w run cli --transport stdio "who am I?",再用真实生产提示验证改动行为。通过标准是本地 CLI 输出 Connected to MCP server (stdio)、走预期 MCP 工具路径并返回真实生产数据;仅 --list-tools 不算 QA。对仅目录的变更工具,除非有可丢弃资源,避免改动真实生产数据,可加服务器级 execute_sentry_tool 分发测试配合 MSW 覆盖。输出格式变更时还应检查原始 MCP 工具结果,对照 docs/contributing/tool-responses.md。
  3. 真实智能体客户端:用于验证 Claude Code、Codex 或仅在真实客户端复现的行为,先构建,再运行 harness;需先预热缓存,因为真实客户端不给 stdio 子进程 TTY。
  4. Cloudflare HTTP:仅当改动涉及 Cloudflare、HTTP 传输、/mcp 路由、OAuth、Web UI 或托管服务器兼容性时执行,先 pnpm dev,再用 curl 检查可达性,并用 --mcp-host 指定作用域 URL 验证。
  5. 源码构建 Stdio:仅在需要检查构建后的本地 stdio 服务器时使用。

限制:资料未提供收费、价格、平台支持范围等更多信息;部分步骤依赖本地 Cloudflare/Wrangler 配置,失败时可记录并继续 stdio QA。