Postmancer

Postmancer

一个独立的 MCP 服务，用于 API 测试和管理，让 AI 助手能够通过自然语言与 RESTful API 交互。

概述

Postmancer 是一款 MCP（Model Context Protocol）服务，可让 Claude 等 AI 助手发送 HTTP 请求、管理 API 端点集合并测试 API 响应。它提供的功能与 Postman 或 Insomnia 等工具类似，但专为 AI 助手设计。

功能

• 向任何 REST API 发送 HTTP 请求
• 在集合中保存和整理请求
• 设置和使用环境变量，并替换变量
• 支持多种身份验证方式（Basic、Bearer、API Key、OAuth2）
• 请求/响应历史记录和测试

快速开始

安装

# Install globally
npm install -g postmancer

# Or run directly with npx
npx postmancer

与 Claude Desktop 搭配使用

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

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

{
  "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

可用工具

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

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：集合的存储路径（默认值：~/.postmancer）
• LOG_LEVEL：日志级别（debug、info、warn、error）（默认值：info）
• POSTMANCER_ENCRYPTION_KEY：用于加密凭据和令牌的密钥（如果未提供，则会生成随机密钥）
• ENCRYPTION_KEY：用于加密标记为机密的环境变量的密钥（如果未提供，则使用默认密钥）

出于生产环境的安全考虑，强烈建议设置这些加密密钥，而不要使用默认值。

许可证

MIT