EasyPostman：API 调试与压测桌面工具

项目简介

EasyPostman 是一款基于 Java 17 的桌面应用，把 Postman 风格的 API 调试与 JMeter 风格的性能测试合在同一个工具里。集合、环境和测试数据默认保存在本地，同时可以通过 Git 工作区做团队协作；同一个工作区还能通过无头 CLI 在 CI 中运行，或通过内置的 MCP Server 交给 AI 客户端调用。

主要功能

• API 调试：HTTP/HTTPS、SSE、WebSocket、认证、Cookie、多种请求体类型、响应查看与网络日志。
• 集合与脚本：支持 Postman v2.1 / cURL 导入，环境变量、前置/后置脚本、断言、请求串联。
• 性能测试：线程组、定时器、提取器、实时指标、报告，以及分布式 master/worker 压测。
• 本地与 Git 工作区：集合、环境与设置相互隔离，存储位置由用户控制。
• MCP 与无头 CLI：让 AI 执行已保存的接口，在 CI 中运行集合、功能测试和压测计划。

安装与使用

从 GitHub Releases 下载安装包，也可使用 Gitee 镜像。原生安装包和 Windows 便携包自带运行时，桌面端和 MCP 都不需要另外安装 Java；只有跨平台 JAR 需要 Java 17+。

Windows 可用 WinGet 安装：

winget install --id Laker.EasyPostman --exact

升级命令：winget upgrade --id Laker.EasyPostman --exact

安装包对应关系：macOS Apple Silicon 用 macos-arm64.dmg，macOS Intel 用 macos-x86_64.dmg，Windows 用 windows-x64.exe 或 -portable.zip，Debian/Ubuntu 用 linux-amd64.deb 或 linux-arm64.deb，RHEL/Rocky/CentOS/Fedora 用 .rpm，跨平台用 easy-postman-{version}.jar。

基本使用流程：

1. 创建本地工作区或连接 Git 工作区。
2. 新建或导入集合，并选择环境。
3. 填写 URL、参数与认证信息，发送请求。
4. 按需添加脚本、断言、功能测试或压测计划。

MCP Server

MCP Server 已包含在每个发布包中，无需单独下载或手动启动服务。安装原生包后，在 Codex、Claude Desktop 或 Cursor 中添加本地 STDIO MCP Server，command 指向对应平台的启动器。macOS 配置示例：

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

其他平台的启动器路径：Windows 安装版为 C:\\Program Files\\EasyPostman\\EasyPostmanMCP.exe，Windows 便携版为解压目录中的 EasyPostmanMCP.exe，Linux DEB/RPM 为 /opt/easypostman/bin/EasyPostmanMCP。args 默认留空即可。

无头 CLI

同一个 JAR 可以直接运行 EasyPostman 原生工作区，无需导出集合和环境：

java -jar easy-postman.jar collection run /srv/api-workspace -c "Basic HTTP Examples" -e "Dev Env"

从源码构建

git clone https://github.com/lakernote/easy-postman.git
mvn -pl easy-postman-app -am -DskipTests clean package
java -jar easy-postman-app/target/easy-postman-*.jar

注意事项

• 首次启动时 Windows SmartScreen 或 macOS Gatekeeper 可能弹出警告，可选择“仍要运行”，或右键 macOS 应用选择“打开”。项目目前未使用商业代码签名证书，全部源码可自行审查。
• MCP 只能发现并执行已授权工作区中保存的 HTTP 请求，不能按需构造任意 URL；接口响应体会返回给 MCP 客户端，请求也可能产生真实业务副作用，因此不要向不可信客户端授权包含敏感数据或生产环境的工作区。
• 使用 Windows 便携包时需保持整个目录完整，EasyPostmanMCP.exe 不能单独拷出使用。

本作品整理自 GitHub 开源项目 lakernote/easy-postman，原作者 @lakernote，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。