SuperAPI AI 工具集

postmancer

Postmancer 是一个实验性的 MCP(Model Context Protocol)服务器,定位为 Postman 和 Insomnia 等 REST 客户端的替代工具。它让 Claude 等 AI 助手通过自然语言与 RESTful API 交互,支持发送 HTTP 请求、管理 API 端点集合、测试 API 响应,以及保存和组织请求、环境变量替换、多种认证方式(Basic、Bearer、API Key、OAuth2)和请求/响应历史记录。可通过 Claude Desktop 配置文件或 Docker 使用。

访问官网

工具介绍

Postmancer 是一个独立的 MCP(Model Context Protocol)服务器,用于 API 测试与管理,允许 AI 助手通过自然语言与 RESTful API 交互。它被设计为 Postman 和 Insomnia 等工具的实验性替代品,但专门面向 AI 助手。

主要能力

Postmancer 为 AI 助手提供以下工具:

  • http_request:向任意 URL 发送 HTTP 请求
  • list_collections:查看所有已保存的 API 集合
  • list_requests:查看某个集合中的所有请求
  • save_request:将请求保存到集合
  • request_from_collection:执行已保存的请求
  • set_environment_variable:为请求模板设置变量
  • get_environment_variables:查看所有环境变量

此外,它支持将请求保存并组织到集合中、设置并使用环境变量及变量替换、多种认证方式(Basic、Bearer、API Key、OAuth2),以及请求/响应历史与测试。

使用方式

在 Claude Desktop 中使用:将配置添加到 Claude Desktop 配置文件。

  • Windows:%USERPROFILE%.claude\claude_desktop_config.json
  • macOS/Linux:~/.claude/claude_desktop_config.json

也支持通过 Docker 使用。

可通过以下环境变量配置 Postmancer:

  • COLLECTIONS_PATH:存储集合的路径(默认:~/.postmancer)
  • LOG_LEVEL:日志级别(debug、info、warn、error)(默认:info)
  • POSTMANCER_ENCRYPTION_KEY:用于加密凭据和令牌的密钥(未提供时生成随机密钥)
  • ENCRYPTION_KEY:用于加密标记为机密的的环境变量的密钥(未提供时使用默认密钥)

适用场景

适合需要通过 AI 助手以自然语言方式发送 HTTP 请求、管理 API 端点集合、测试 API 响应,以及保存和组织请求的场景,可替代 Postman 或 Insomnia 的部分功能。

限制

该项目被标注为“实验性”。生产环境的安全性方面,强烈建议设置上述加密密钥,而不是使用默认值。