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 的部分功能。
限制
该项目被标注为“实验性”。生产环境的安全性方面,强烈建议设置上述加密密钥,而不是使用默认值。