EasyPostman MCP Server 完整教程：让 Codex、Claude Desktop 与 Cursor 直接调用你保存的 API 请求

开发工具接口测试性能测试桌面应用MCP 服务【免费下载链接】easy-postmanAn open-source API debugging and stress testing tool inspired by Postman and a simplified JMeter, optimized for developers with a clean UI and powerful features.项目地址https://gitcode.com/gh_mirrors/ea/easy-postman点击查看免费下载EasyPostman 是一款开源的 API 调试与压测工具现在它内置了标准 MCP Server——你只需一条命令就能让 Codex、Claude Desktop、Cursor 等 AI 客户端发现你保存的工作区并直接执行已保存的 HTTP 请求和整个集合。不用手写 curl不用复制粘贴接口文档AI 助手从此能动手调用你的 API 了。EasyPostman MCP Server 是什么为什么值得配MCPModel Context Protocol让 AI 客户端可以调用外部工具。EasyPostman 内置了一个MCP stdio Server它的作用很直接发现AI 可以列出你所有工作区、集合、环境和已保存的请求执行AI 可以按requestId执行单个请求或按collectionId跑完整个集合隔离MCP 直接复用桌面端的无头执行链变量、脚本、Cookie、TLS 语义完全一致但不模拟点击页面也不会改变桌面端当前的选择。 一句话理解你在 EasyPostman 里辛苦整理好的接口资产现在变成了 AI 能直接操作的工具箱。三步安装找到 MCP 启动器MCP 已包含在主程序里不需要单独安装。三种下载方式对应不同的启动入口下载方式MCP 启动入口是否需另装 JavamacOS / Windows / Linux 原生安装包包内的EasyPostmanMCP启动器否已含 JREWindows 便携版 ZIP解压目录中的EasyPostmanMCP.exe否已含 JRE跨平台 JARjava -jar easy-postman.jar mcp serve是需 Java 17各平台原生启动器位置平台command路径macOS/Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCPWindows 安装版C:\Program Files\EasyPostman\EasyPostmanMCP.exeWindows 便携版解压目录中的EasyPostmanMCP.exeLinux DEB / RPM/opt/easypostman/bin/EasyPostmanMCP⚠️两个常见坑原生启动器会自动补上mcp serve所以 JSON 配置里的args必须为空数组不要再写mcp, serveWindows 便携版要完整解压不能只复制EasyPostmanMCP.exe——它和桌面端共享同一个 JAR 与运行时。启动器的工作原理见 McpLauncher.java。最快配置方法Codex、Claude Desktop、Cursor 客户端配置示例Codex CLI 一条命令搞定codex mcp add easy-postman -- /Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCPClaude Desktop / Cursor / Claude CodeJSON 配置{ 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 如何看到并执行你的 APIMCP 提供 6 个工具典型调用链是list_workspaces → list_collections / list_environments → list_requests → run_request / run_collectionTool主要输入用途list_workspaces无列出已授权的工作区及稳定 IDlist_collectionsworkspaceId?列出集合、描述和请求数量list_environmentsworkspaceId?列出环境和变量名不返回变量值list_requestsworkspaceId?、collectionId?、query?、limit?按集合或关键词查找已保存请求run_requestrequestId必填执行一个 HTTP 请求run_collectioncollectionId必填执行整个集合工具定义源码见 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 KiB10 MiB会话隔离每次 Tool 调用前后清空 Cookie不同调用和工作区之间不继承会话。最佳实践如需严格限制启动时传入专用工作区目录只授权一个工作区并在其中只保留允许 AI 调用的 API生产工作区只授权给可信的 MCP 客户端。单工作区授权配置示例{ command: /Applications/EasyPostman.app/Contents/MacOS/EasyPostmanMCP, args: [/absolute/path/to/my-api-workspace] }安装排查清单现象排查方法启动器打不开先运行EasyPostmanMCP --help能显示帮助说明启动器和内置 JRE 完整客户端连不上command用绝对路径Windows JSON 路径反斜杠需转义带空格路径要加引号Codex 命令不对codex mcp get easy-postman --json检查最终保存的命令工作区列表不更新桌面端新增/移除工作区后重启 MCP 客户端连接stdout 出现乱码日志正常运行时 stdout 只有 JSON-RPC必要错误脱敏后写 stderr进程模型上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 服务【免费下载链接】easy-postmanAn open-source API debugging and stress testing tool inspired by Postman and a simplified JMeter, optimized for developers with a clean UI and powerful features.项目地址https://gitcode.com/gh_mirrors/ea/easy-postman点击查看免费下载相关推荐让Claude和Cursor直接读公众号文章wechat-download-api MCP接入完整教程让Claude和Cursor直接读公众号文章wechat download api MCP接入完整教程 wechat download api 是一款完全开源后端网页爬虫MCP 服务如何用Clauge内置的MCP服务器让Claude Desktop与Cursor直接操控你的Workspace如何用Clauge内置的MCP服务器让Claude Desktop与Cursor直接操控你的Workspace Clauge 是一款面向开发者的 AI 超级应如何为ChatbotX接入MCP Server让Claude和Cursor直接操控营销工作区的完整教程如何为ChatbotX接入MCP Server让Claude和Cursor直接操控营销工作区的完整教程 ChatbotX 是一款开源的多渠道营销自动化平台覆上一篇NCM 转 MP3 完整指南ncmdump 拖拽即用3 分钟转出第一首歌下一篇Presto 0.239.2 发布说明classification_precision 聚合函数错误结果修复深度解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考