用途
api-testing-mcp 是一个完整的 API 测试 MCP 服务器，不只是请求发送器，而是完整的测试工作台。它通过自然语言对话即可完成 HTTP 请求、断言验证、多步骤流程、OpenAPI 导入、模拟数据、负载测试、响应差异对比、批量测试运行、可复用集合与环境管理等工作。无需账户、无云端同步、不生成文件，全部内联运行并以纯 JSON 存储。
主要能力
- HTTP 请求：支持 GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS，可设置请求头、查询参数、JSON 正文、Bearer / API Key / Basic 认证与自定义超时；相对 URL 会根据 BASE_URL 自动解析；支持 {{variable}} 插值。
- 压缩模式：默认返回压缩响应，可减少 70–95% 的 token。三种模式：minimal（仅状态、耗时、大小与前 200 字符正文，约省 95%）、normal（默认，过滤响应头并将正文截断至 max_body_bytes，约省 75%）、full（完整响应）。压缩响应含 call_id，可用 inspect_last_response({ call_id }) 恢复完整正文，无需重新请求；响应保存在 20 槽环形缓冲并持久化到 .api-testing/last-responses/，TTL 1 小时。only_fields 支持点路径、数组索引与通配符（如 items[*].name），仅返回指定字段。
- 断言：以结构化通过/失败结果验证响应，提供 10 个运算符：eq、neq、gt、gte、lt、lte、contains、not_contains、exists、type。
- 流程：通过变量提取串联请求，适合认证流程和 CRUD 序列。
- OpenAPI：从 URL 或本地文件导入 JSON/YAML 规范，支持 OpenAPI 3.x（完整 $ref 解析、allOf、oneOf、anyOf），部分支持 OpenAPI 2.0。导入后 AI 知晓每个端点、参数与模式。
- 模拟数据：基于 OpenAPI 模式生成真实感假数据，遵守类型、格式（email、uuid、date-time）、枚举与必填字段。
- 负载测试：发起 N 个并发请求并获取性能指标（含百分位指标）。
- 响应差异：执行两个请求并逐字段比较响应，检测回归或对比环境。
- 批量测试：运行集合中的全部已保存请求（或按标签筛选）并获取摘要。
- 集合与标签：保存请求以便复用，支持标签与回归套件。
- 环境：管理变量（BASE_URL、令牌、API 密钥），按上下文隔离。核心概念包括组（组织环境并绑定到目录，一组有 N 个作用域共享环境，且恰有一个默认环境；进入组的作用域时其环境自动可用）、默认环境（进入作用域时自动激活，跨会话持久）、活动环境（当前用于变量解析，进入作用域时从默认开始，可随时切换，会话结束重置为默认）。全局环境需用 env_switch 显式激活且不跨会话持久。变量会自动插值到 URL、请求头、查询参数与请求体中。
- 凭据安全：凭据不离开本机；环境文件为纯 JSON，存于 ~/.api-testing/，不同步云端、不嵌入导出、不被 git 跟踪。
- Postman 导入导出：双向支持 Postman v2.1。导入集合时文件夹转为标签，认证从文件夹/集合层级继承，支持 raw JSON、x-www-form-urlencoded、form-data 正文；导入环境时优先取 currentValue 而非 value，跳过禁用变量，可选 activate。导出集合按标签分组为文件夹，认证映射为 Postman 原生格式，{{variables}} 原样保留；导出环境所有变量为 enabled: true。
- 原生导入导出：将集合与环境导出为可移植的 .atm/ 文件夹，便于分享或跨项目复制；首次导出时 .atm/ 自动加入 .gitignore。
- cURL 导出：将已保存请求转为可直接粘贴的 cURL 命令（变量已解析）。
使用方式
安装：在各 MCP 客户端配置文件中添加服务器配置。macOS 的 Claude 配置位于 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json；Cursor / Windsurf 添加至项目根目录的 .cursor/mcp.json 或 .windsurf/mcp.json；VS Code 添加至 .vscode/mcp.json；Codex CLI (OpenAI) 可添加至 ~/.codex/config.toml；Gemini CLI 添加至 ~/.gemini/settings.json。 使用流程：安装后创建环境，使相对路径自动解析；若有 Swagger/OpenAPI 规范则导入；用“List my environments”验证应能看到刚创建的环境。之后直接用自然语言描述需求，AI 会选择合适的工具。
存储与架构
全部本地，无数据库、无云同步、无遥测。所有数据以纯 JSON 存于 ~/.api-testing/，可随时读取、备份或删除。全局存储用于凭据，导出到项目根目录的 .atm/ 不包含凭据，可安全分享。可通过 API_TESTING_DIR 覆盖默认存储路径；若覆盖到 git 仓库内，需将 .api-testing/ 加入 .gitignore。技术栈：TypeScript (strict)、MCP SDK、Zod、Vitest、tsup。MIT 许可。
适用场景与限制
适用于需要 AI 辅助进行 API 测试与调试的开发者，支持任意 MCP 客户端。需注意：每个已注册 MCP 会带来每会话约 300–600 token 的固定开销，通常每会话 1–2 次真实调用即可回本；全局环境需显式激活且不持久；OpenAPI 2.0 仅部分支持。产品的收费、价格、平台等信息暂未提供。
