MCP开源邮递员
缺少用于模型上下文协议服务器的开发工具。
使用实际与stdio传输兼容的桌面GUI测试和调试MCP服务器——因为说实话,大多数MCP服务器都不是HTTP。
______________________________________________________________________
问题
MCP是惊人的,但测试服务器是痛苦的:
- 无可视化工具 --您在终端中被JSON-RPC日志卡住了
- 无架构检查器 --“这个工具需要什么参数?”祝你好运
- 无请求历史记录 --重播请求意味着重新键入所有内容
- 仅支持HTTP的工具 -90%的MCP服务器使用stdio,这是大多数API客户端无法处理的
MCP的开源Postman解决了这个问题。连接到任何MCP服务器(stdio、HTTP或SSE),使用自动生成的表单探索其工具,一键执行请求,并将所有内容保存到历史记录中。
______________________________________________________________________
特性
- 多运输支持 --stdio、HTTP和SSE(最后,一个正确处理stdio的工具)
- 模式检查器 --查看完整的JSON模式、自动生成的输入表单
- AI自动选择 --用简单的英语描述你想要什么,让克劳德选择正确的工具+args
- 请求历史 --一键回放保存到SQLite的每个请求
- 暗模式用户界面 --邮差/失眠风格的界面,不会伤害你的眼睛
______________________________________________________________________
快速开始
git clone https://github.com/baristaGeek/open-source-postman-for-mcp
cd open-source-postman-for-mcp
npm install
npm run dev______________________________________________________________________
用法
连接到stdio服务器
大多数MCP服务器使用stdio传输(如官方文件系统服务器):
- 选择 工作室 运输
- 输入命令:
npx -y @modelcontextprotocol/server-filesystem /tmp - 点击 连接
- 浏览工具,填写参数,执行
连接到HTTP服务器
对于基于HTTP的MCP服务器:
- 选择 超文本传输协议 运输
- 输入URL:
http://localhost:3001 - (可选)在“身份验证”下拉菜单下添加身份验证
- 点击 连接
______________________________________________________________________
配置
复制 .env.example 到 .env:
cp .env.example .env所需的环境变量:
# Required for AI features (auto-select, summarization)
ANTHROPIC_API_KEY=sk-ant-...
# Required for credential encryption (generate with: openssl rand -hex 32)
MCP_SECRET_KEY=your-32-byte-hex-key
# Database location (default: ./dev.db)
DATABASE_URL=file:./dev.db生成密钥:
openssl rand -hex 32______________________________________________________________________
建筑
┌─────────────────────────────────────────────┐
│ Next.js 15 App │
├──────────┬──────────────────┬───────────────┤
│ Sidebar │ Request Builder │ Response │
│ • Tools │ • Form inputs │ • JSON │
│ • History│ • JSON editor │ • Errors │
│ │ • Schema view │ • Timing │
├──────────┴──────────────────┴───────────────┤
│ API Routes │
│ /api/stdio/* — stdio process manager │
│ /api/tools/* — HTTP/SSE transport │
│ /api/history — SQLite persistence │
│ /api/summarize — AI-powered summarization │
└─────────────────────────────────────────────┘技术栈:
- Next.js 15+React 19(应用路由器)
- 顺风CSS(GitHub深色主题)
- Prisma+SQLite(历史+配置持久性)
- Anthropic SDK(人工智能功能)
- TypeScript贯穿始终
______________________________________________________________________
为什么存在
我在使用MCP服务器时构建了这个,厌倦了:
- 在一个终端上运行服务器,在另一个终端中运行客户端,手动复制JSON-RPC有效载荷
- 深入服务器源代码,找出工具接受哪些参数
- 邮递员/Insomnia不支持stdio(大多数MCP服务器使用)
- 无法重播以前的请求或调试失败
MCP的开源Postman是我希望从第一天起就存在的开发工具。
______________________________________________________________________
路线图
- \[\]导出请求集合(邮递员)
- \[\]可重用配置的环境变量
- \[\]批处理/脚本化请求
- \[\]工具描述语法高亮显示(Markdown)
- \[\]桌面应用程序(Electron/Tauri)可更好地处理stdio
______________________________________________________________________
贡献
PR欢迎!该项目旨在 这 MCP的标准测试工具。
需要帮助的领域:
- 苏格兰和南方能源公司运输(目前被淘汰)
- 更好的stdio故障错误消息
- 请求差异/比较视图
- 更多示例服务器
______________________________________________________________________
许可证
麻省理工学院——随心所欲地使用它。
______________________________________________________________________
积分
建造于 @baristaGeek 因为MCP生态系统需要合适的开发工具。
如果你觉得这很酷,就给它一颗星⭐
