Postman 管理器

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

概述

Postmancer 是一个 MCP（模型上下文协议）服务器，使 AI 助手如Claude能够发送 HTTP 请求、管理 API 端点收藏夹以及测试 API 响应。它提供了类似 Postman 或 Insomnia 的功能，但专为 AI 助手设计。

特性

• 发送任意 REST API 的 HTTP 请求
• 保存并组织请求到收藏夹中
• 设置和使用环境变量进行变量替换
• 支持多种身份验证方法（基本认证、Bearer Token、API Key、OAuth2）
• 提供请求/响应历史记录和测试功能

快速入门

安装

# 全局安装
npm install -g postmancer

# 或直接运行
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 - 发送 HTTP 请求到任意 URL
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