API测试管理工具

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

  • by hijaz
  • TypeScript
  • 本地部署
  • 29 星标
  • 更新于
在 GitHub 查看 hijaz/postmancer

使用说明

邮递员

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

概述

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

特性

  • 向任何REST API发出HTTP请求
  • 在集合中保存和组织请求
  • 设置和使用具有变量替换的环境变量
  • 多种身份验证方法(基本、承载、API密钥、OAuth2)
  • 请求/响应历史和测试

快速开始

安装

# Install globally
npm install -g postmancer

# Or run directly with npx
npx postmancer

与Claude Desktop一起使用

将此添加到您的Claude Desktop配置文件中:

  • 窗户: %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

可用工具

Postmanager为AI助手提供以下工具:

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

配置

使用以下环境变量配置Postmanager:

  • COLLECTIONS_PATH:存储集合的路径(默认:~/.postancer)
  • LOG_LEVEL:日志记录级别(调试、信息、警告、错误)(默认值:信息)
  • POSTMANCER_ENCRYPTION_KEY:用于加密凭证和令牌的密钥(如果未提供,则生成随机密钥)
  • ENCRYPTION_KEY:用于加密标记为机密的环境变量的密钥(如果未提供,则使用默认密钥)

为了生产环境中的安全,强烈建议设置这些加密密钥,而不是使用默认值。

许可证

麻省理工学院