• 开发工具
• 接口测试
• 性能测试
• 桌面应用
• MCP 服务

EasyPostman 是一款开源的 API 调试与压测工具，现在它内置了标准 MCP Server——你只需一条命令，就能让 Codex、Claude Desktop、Cursor 等 AI 客户端发现你保存的工作区，并直接执行已保存的 HTTP 请求和整个集合。不用手写 curl，不用复制粘贴接口文档，AI 助手从此能"动手"调用你的 API 了。

EasyPostman MCP Server 是什么？为什么值得配？

MCP（Model Context Protocol）让 AI 客户端可以调用外部工具。EasyPostman 内置了一个MCP stdio Server，它的作用很直接：

• 发现：AI 可以列出你所有工作区、集合、环境和已保存的请求；
• 执行：AI 可以按requestId执行单个请求，或按collectionId跑完整个集合；
• 隔离：MCP 直接复用桌面端的无头执行链（变量、脚本、Cookie、TLS 语义完全一致），但不模拟点击页面，也不会改变桌面端当前的选择。

💡 一句话理解：你在 EasyPostman 里辛苦整理好的接口资产，现在变成了 AI 能直接操作的"工具箱"。

三步安装：找到 MCP 启动器

MCP 已包含在主程序里，不需要单独安装。三种下载方式对应不同的启动入口：

各平台原生启动器位置：

⚠️两个常见坑：

1. 原生启动器会自动补上mcp serve，所以 JSON 配置里的args必须为空数组，不要再写"mcp", "serve"；
2. Windows 便携版要完整解压，不能只复制EasyPostmanMCP.exe——它和桌面端共享同一个 JAR 与运行时。

启动器的工作原理见 McpLauncher.java。

最快配置方法：Codex、Claude Desktop、Cursor 客户端配置示例

Codex CLI 一条命令搞定

codex mcp add easy-postman -- /Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCP

Claude Desktop / Cursor / Claude Code（JSON 配置）

{ "mcpServers": { "easy-postman": { "command": "/Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCP", "args": [] } } }

Windows 下 JSON 路径的反斜杠要写成双反斜杠，例如：

{ "mcpServers": { "easy-postman": { "command": "D:\\Tools\\EasyPostman\\EasyPostmanMCP.exe", "args": [] } } }

JAR 备用方式（需要 Java 17+）：

{ "command": "java", "args": ["-jar", "/path/to/easy-postman.jar", "mcp", "serve"] }

保存后重启客户端并新建对话，然后做只读验证：

请使用 EasyPostman MCP 列出所有工作区，不要执行任何接口。

6 个内置工具：AI 如何"看到"并执行你的 API

MCP 提供 6 个工具，典型调用链是：

list_workspaces → list_collections / list_environments → list_requests → run_request / run_collection

工具定义源码见 McpToolSpecifications.java，服务端协议层在 easy-postman-mcp/ 模块。

现在你可以对 AI 说自然语言，例如：

"在示例工作区里找到 GET Example 请求，用 Dev 环境执行它"

AI 会自动完成"查找 → 选择环境 → 执行 → 读响应"的完整流程。

环境与变量覆盖：本次调用只生效，不落盘

执行时可以指定environmentId（传环境 ID 或精确名称），并用environmentOverrides临时覆盖变量：

{ "environmentId": "development", "environmentOverrides": { "baseUrl": "http://127.0.0.1:8080", "apiToken": "temporary-value" } }

覆盖值只在本次运行的内存中生效，不会修改environments.json，返回结果也只回显被覆盖的变量名，不回显输入值。

授权与安全边界：生产工作区要谨慎

MCP 的授权粒度是**"工作区"**，源码实现在 McpWorkspaceCatalog.java。几个关键的安全设计：

• 只授权不猜路径：workspaceId不接受任意本机目录，只能匹配进程启动时已授权的 ID；
• 只读优先：v1 不提供导入、保存、删除等写操作工具；
• 敏感数据脱敏：常见认证响应头、token/key/password/secret 类头、URL 中的 user-info 与敏感查询参数、响应体中的敏感键值会自动脱敏（见 McpSensitiveDataRedactor.java）；
• 响应体有上限：默认 64 KiB，可通过--max-response-bytes调整为 1 KiB～10 MiB；
• 会话隔离：每次 Tool 调用前后清空 Cookie，不同调用和工作区之间不继承会话。

🔒最佳实践：如需严格限制，启动时传入专用工作区目录只授权一个工作区，并在其中只保留允许 AI 调用的 API；生产工作区只授权给可信的 MCP 客户端。

单工作区授权配置示例：

{ "command": "/Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCP", "args": ["/absolute/path/to/my-api-workspace"] }

安装排查清单

进程模型上，MCP 客户端为一次连接启动一个EasyPostmanMCP进程并在多次 Tool 调用间复用；连接结束后 stdin 关闭，进程随之退出，不需要维护常驻服务。桌面应用与 MCP 是两个独立进程，可同时运行、读取同一批工作区。

总结与延伸阅读

EasyPostman 的 MCP Server 把"接口资产"变成了"AI 可执行资产"：配置只需一条命令或一段 JSON，执行链与桌面端完全一致，安全边界清晰可控。把它接入 Codex、Claude Desktop 或 Cursor 后，调试 API、跑回归集合、验证环境切换，都可以交给自然语言完成。

• 官方设计文档：docs/MCP_SERVER_DESIGN_zh.md
• 协议层源码：EasyPostmanMcpServer.java
• 工具执行服务：McpWorkspaceToolService.java
• 架构总览：docs/ARCHITECTURE_zh.md

• 开发工具
• 接口测试
• 性能测试
• 桌面应用
• MCP 服务