Postman MCP Server Aio

🚀 郵政人 MCP サーバー

このプロジェクトは Cloudflare Worker を利用し、Claude AI の MCP（モデル制御平面）インターフェースを通じて、Postman コレクションと環境への API アクセスを提供します。

🚀 クイックスタート

このサーバーを使うことで、Claude AI が Postman コレクションと環境とやり取りし、以下の操作を実行できます。

• すべてのコレクションを取得
• 特定のコレクションの詳細情報を取得
• 新しいコレクションを作成
• コレクションにリクエストを追加
• コレクションを実行し、テスト結果を取得

これにより、Claude が API テスト、ドキュメント作成、管理タスクを支援することが可能になります。

✨ 主な機能

郵政人 MCP サーバーは以下のメソッドを提供します。

基本ツールメソッド

• mcp__sayHello(name) - 提供された名前を含む挨拶を返します。
• mcp__reverseString(input) - 文字列の文字順を反転します。

コレクションメソッド

• mcp__get_collections() - Postman アカウント内のすべてのコレクションを取得します。
• mcp__get_collection(collectionId) - 特定のコレクションの詳細情報を取得します。
• mcp__create_collection(name, description) - 新しいコレクションを作成します。
• mcp__add_request(collectionId, name, method, url, ...) - コレクションにリクエストを追加します。

環境メソッド

• mcp__get_environments() - Postman アカウント内のすべての環境を取得します。
• mcp__get_environment(environmentId) - 特定の環境の詳細情報を取得します。
• mcp__create_environment(name, variables) - 変数を含む新しい環境を作成します。

テスト実行

• mcp__run_collection(collectionId, environmentId) - オプションの環境を使用してコレクションを実行します。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします：npm install
3. .env.example を .env にコピーし、Postman API キーを追加します。
4. Cloudflare ワーカーにデプロイします：wrangler deploy

💻 使用例

基本的な使用法

npm run dev

これにより、wrangler を使用してローカルでサーバーが起動します。

📚 ドキュメント

プロジェクト構造

• /src - ソースコード
  • /interfaces - TypeScript インターフェース
  • /services - サービスクラス
  • index.ts - メインワーカープログラムのエントリーポイント
• /test - 単体テスト
• /examples - サンプルの使用方法
• /docs - 追加のドキュメント

サンプル

詳細なサンプルについては、examples/postman-examples.md ファイルを参照してください。

デプロイ

Cloudflare ワーカーにデプロイするには、以下のコマンドを実行します。

npm run deploy

wrangler.toml ファイルが正しく設定されていることを確認してください。

🔧 技術詳細

セキュリティ

このサーバーを実行するには、Postman API キーが必要です。キーを Cloudflare ワーカーの環境変数に安全に保存し、バージョン管理にコミットしないようにしてください。

コントリビューションガイド

1. DEVELOPMENT_GUIDELINES.md に従ってください。
2. SOLID_PRINCIPLES.md を遵守してコード設計を行ってください。