Postman Tool Generation MCP Server

Postman Tool Generation MCP サーバー

Postman のコレクションやリクエストから AI エージェントのツールを生成する MCP サーバーです。このサーバーは Postman API と連携し、API エンドポイントをさまざまな AI フレームワークで使用できる型安全なコードに変換します。

Model Context Protocol（MCP）は、大規模言語モデル（LLM）と外部システムの間でコンテキストを管理するための新しい標準プロトコルです。このリポジトリでは、Postman Tool Generation API用のインストーラーと MCP サーバーを提供しています。

これにより、Claude DesktopやClineなどの任意の MCP クライアントで、自然言語を使って Postman アカウントの操作を行えます。たとえば、次のように指定できます。

• Create an AI tool for: collectionID: 12345-abcde requestID: 67890-fghij typescript openai

機能

• Postman コレクションから TypeScript／JavaScript コードを生成
• 複数の AI フレームワークをサポート（OpenAI、Mistral、Gemini、Anthropic、LangChain、AutoGen）
• 型安全なコード生成
• エラー処理とレスポンスの検証

デモ

セットアップ

1. 依存関係をインストールします。

npm install

2. サーバーをビルドします。

npm run build

3. Claude の設定ファイル（cline_mcp_settings.json）に次の内容を追加して、MCP の設定を行います。

{
  "mcpServers": {
    "postman-ai-tools": {
      "command": "node",
      "args": [
        "/path/to/postman-tool-generation-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使い方

このサーバーは、次のパラメーターを持つ generate_ai_tool という単一のツールを提供します。

{
  collectionId: string;    // The Public API Network collection ID
  requestId: string;       // The public request ID
  language: "javascript" | "typescript";  // Programming language to use
  agentFramework: "openai" | "mistral" | "gemini" | "anthropic" | "langchain" | "autogen";  // AI framework
}

例

// Using the tool through MCP
const result = await use_mcp_tool({
  server_name: "postman-ai-tools",
  tool_name: "generate_ai_tool",
  arguments: {
    collectionId: "your-collection-id",
    requestId: "your-request-id",
    language: "typescript",
    agentFramework: "openai"
  }
});

生成されるコード

このツールは、次の内容を含む型安全なコードを生成します。

• リクエスト／レスポンスの型定義
• エラー処理
• API 連携
• OpenAI の関数定義
• ドキュメントと使用例

開発

1. 依存関係をインストールします。

npm install

2. src/index.ts を変更します。

3. サーバーをビルドします。

npm run build

4. Claude アプリを再起動して、更新されたサーバーを読み込みます。

環境変数

• POSTMAN_API_KEY：Postman API キー（必須）

エラー処理

このサーバーには、次のような問題に対する包括的なエラー処理が含まれています。

• 無効なパラメーター
• API の失敗
• JSON の解析エラー
• ネットワークの問題

エラーレスポンスには、問題の診断に役立つ詳細なメッセージが含まれます。

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス