【技术文档摘要】：

Postmancer

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

概述

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

功能

• 向任何REST API发起HTTP请求
• 将请求保存并组织在集合中
• 设置和使用环境变量及变量替换
• 多种身份验证方法（基本、Bearer、API密钥、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