Postmancer

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

概述

Postmancer 是一个 MCP (模型上下文协议) 服务器，它使像 Claude 这样的 AI 助手能够发出 HTTP 请求、管理 API 端点集合以及测试 API 响应。它提供了类似于 Postman 或 Insomnia 等工具的功能，但专门为 AI 助手设计。

特性

• 向任何 REST API 发出 HTTP 请求
• 在集合中保存和组织请求
• 设置和使用带有变量替换的环境变量
• 多种身份验证方法（Basic, Bearer, API Key, OAuth2）
• 请求/响应历史记录和测试

快速开始

安装

# 全局安装
npm install -g postmancer

# 或者直接使用 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