AI导哈

MCP服务器调试工具

开源Postman for MCP是一个桌面GUI工具，用于测试和调试Model Context Protocol（MCP）服务器，支持stdio、HTTP和SSE传输，提供自动生成的表单、请求历史记录和AI自动选择功能。

  • by baristaGeek
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 baristaGeek/open-source-postman-for-mcp

使用说明

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传输（如官方文件系统服务器）：

  1. 选择 工作室 运输
  2. 输入命令： npx -y @modelcontextprotocol/server-filesystem /tmp
  3. 点击 连接
  4. 浏览工具，填写参数，执行

连接到HTTP服务器

对于基于HTTP的MCP服务器：

  1. 选择 超文本传输协议 运输
  2. 输入URL: http://localhost:3001
  3. （可选）在“身份验证”下拉菜单下添加身份验证
  4. 点击 连接

配置

复制 .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服务器时构建了这个，厌倦了：

  1. 在一个终端上运行服务器，在另一个终端中运行客户端，手动复制JSON-RPC有效载荷
  2. 深入服务器源代码，找出工具接受哪些参数
  3. 邮递员/Insomnia不支持stdio（大多数MCP服务器使用）
  4. 无法重播以前的请求或调试失败

MCP的开源Postman是我希望从第一天起就存在的开发工具。

路线图

  • []导出请求集合（邮递员）
  • []可重用配置的环境变量
  • []批处理/脚本化请求
  • []工具描述语法高亮显示（Markdown）
  • []桌面应用程序（Electron/Tauri）可更好地处理stdio

贡献

PR欢迎！该项目旨在 这 MCP的标准测试工具。

需要帮助的领域：

  • 苏格兰和南方能源公司运输（目前被淘汰）
  • 更好的stdio故障错误消息
  • 请求差异/比较视图
  • 更多示例服务器

许可证

麻省理工学院——随心所欲地使用它。

积分

建造于 @baristaGeek 因为MCP生态系统需要合适的开发工具。

如果你觉得这很酷，就给它一颗星⭐

相关 MCP