Postmancer

Postmancer

API のテストと管理を行うスタンドアロンの MCP サーバーです。AI アシスタントが自然言語を通じて RESTful API とやり取りできます。

概要

Postmancer は、Claude などの AI アシスタントが HTTP リクエストを送信し、API エンドポイントのコレクションを管理して、API レスポンスをテストできる MCP（Model Context Protocol）サーバーです。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