Postmancer

基本能力

产品定位

Postmancer 是一个专为 AI 助手设计的 API 测试和管理工具，使其能够通过自然语言与 RESTful API 进行交互。

核心功能

• 向任何 REST API 发送 HTTP 请求
• 在集合中保存和组织请求
• 设置和使用环境变量进行变量替换
• 多种认证方法（Basic、Bearer、API Key、OAuth2）
• 请求/响应历史记录和测试

适用场景

• AI 助手需要与 RESTful API 交互的场景
• API 测试和管理
• 自动化 API 请求和响应测试

工具列表

1. http_request - 向任何 URL 发送 HTTP 请求
2. list_collections - 查看所有保存的 API 集合
3. list_requests - 查看集合中的所有请求
4. save_request - 将请求保存到集合中
5. request_from_collection - 执行保存的请求
6. set_environment_variable - 为请求模板设置变量
7. get_environment_variables - 查看所有环境变量

常见问题解答

• 如何配置 Postmancer？ 通过环境变量配置，如 COLLECTIONS_PATH、LOG_LEVEL、POSTMANCER_ENCRYPTION_KEY 和 ENCRYPTION_KEY。
• 如何确保生产环境的安全性？ 强烈建议设置加密密钥，而不是使用默认值。

使用教程

使用依赖

• Node.js 环境

安装教程

# 全局安装
npm install -g postmancer

# 或直接运行
npx postmancer

与 Claude Desktop 一起使用

在 Claude Desktop 配置文件中添加以下内容：

{
  "mcpServers": {
    "postmancer": {
      "command": "npx",
      "args": ["-y", "postmancer"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

使用 Docker

docker run -i --rm \
  --mount type=bind,src=/path/to/collections,dst=/data/collections \
  postmancer

调试方式

• 设置 LOG_LEVEL 环境变量为 debug 以获取详细日志。
• 检查集合路径和环境变量是否正确配置。

许可证

该项目遵循 MIT 开源许可条款。