Postman MCP Generator

Postman MCP Generator

生成された MCP サーバーへようこそ！ 🚀 このプロジェクトは、Postman MCP Generator を使用し、Model Context Provider（MCP） のサーバー出力モードを設定して作成されました。次のものが含まれています。

• ✅ MCP 互換のサーバー（mcpServer.js）
• ✅ 選択した Postman API リクエストごとに自動生成された JavaScript ツール

セットアップを始めましょう！

🚦 はじめに

⚙️ 前提条件

開始する前に、次のものが揃っていることを確認してください。

• Node.js（v18 以上が必要、v20 以上を推奨）
• npm（Node に含まれています）

警告：Node のバージョンが低い場合、fetch は使用できません。ツールは HTTP 呼び出しに fetch を使用します。これを回避するには、ツールを変更して代わりに node-fetch を使用できます。その場合、node-fetch が依存関係としてインストールされていることを確認し、各ツールファイルで fetch としてインポートしてください。

📥 インストールとセットアップ

1. 依存関係をインストールする

プロジェクトのルートディレクトリで実行します。

npm install

🔐 ツールの環境変数を設定する

.env ファイルには、選択したツールの取得元となる各ワークスペースに対応する環境変数のプレースホルダーがあります。たとえば、Acme と Widgets など、2 つのワークスペースからリクエストを選択した場合、次の 2 つのプレースホルダーが表示されます。

ACME_API_KEY=
WIDGETS_API_KEY=

各 API の実際の API キーで値を更新してください。これらの環境変数は、生成されたツール内で各リクエストの API キーを設定するために使用されます。tools ディレクトリ内のファイルを確認すると、仕組みがわかります。

// environment variables are used inside of each tool file
const apiKey = process.env.ACME_API_KEY;

注意点： すべての API で正しく機能するとは限りません。生成ロジックは比較的シンプルで、各ワークスペースについて、ワークスペースのスラッグと同じ名前の環境変数を作成し、そのワークスペースに属する各ツールファイルでその環境変数を使用します。選択した API にこの動作が適さない場合でも問題ありません。.env ファイルやツールファイルを手動で更新して、API の認証方法に正しく対応させることができます。

🌐 Postman で MCP サーバーをテストする

MCP サーバー（mcpServer.js）は、自動化された API ツールを Claude Desktop や Postman Desktop Application などの MCP 互換クライアントに公開します。まず Postman でサーバーをテストしてから、LLM での使用に進むことをおすすめします。

Postman Desktop Application は、MCP サーバーの実行とテストに最も簡単な方法です。ダウンロードしたサーバーを先にテストするかどうかは任意ですが、実施することをおすすめします。

Step 1：最新の Postman Desktop Application を https://www.postman.com/downloads/ からダウンロードします。

Step 2：ドキュメント記事こちらを読み、Postman アプリ内で MCP リクエストを作成する方法を確認します。

Step 3：MCP リクエストの種類を STDIO に設定し、コマンドを node </absolute/path/to/mcpServer.js> に設定します。node のみを使用して問題が発生する場合（古いバージョンが使用されている場合など）は、代わりに Node v18 以上の絶対パスを指定してください。次のコマンドを実行すると、Node の完全なパスを取得できます。

which node

Node のバージョンを確認するには、次を実行します。

node --version

mcpServer.js の絶対パスを取得するには、次を実行します。

realpath mcpServer.js

Node コマンドの後に mcpServer.js の完全なパスを指定し、新しい Postman MCP リクエストのコマンドとして使用します。その後、Connect ボタンをクリックします。サーバーの生成前に選択したツールの一覧が表示されます。MCP サーバーを LLM に接続する前に、ここで各ツールが動作することをテストできます。

👩‍💻 MCP サーバーを Claude に接続する

MCP サーバーは、任意の MCP クライアントに接続できます。ここでは、Claude Desktop に接続する手順を説明します。

ステップ 1：前の手順で確認した、node と mcpServer.js のフルパスを控えておきます。

ステップ 2：Claude Desktop → Settings → Developers → Edit Config を開き、新しい MCP サーバーを追加します。

{
  "mcpServers": {
    "<server_name>": {
      "command": "<absolute/path/to/node>",
      "args": ["<absolute/path/to/mcpServer.js>"]
    }
  }
}

Claude Desktop を再起動して、この変更を有効にします。新しい MCP がオンになっていて、その横に緑色の丸が表示されていることを確認してください。表示されていれば、接続したツールを使用できるチャットセッションを開始する準備ができています。

警告：v18 以降の node の絶対パスを指定しない場合、Claude（およびその他の MCP クライアント）は、システム上にある古いバージョンの node にフォールバックすることがあります。この場合、fetch API が使用できず、ツール呼び出しが機能しません。その場合は、a）新しいバージョンの node をインストールして、コマンドでそのパスを指定するか、b）各ツールに node-fetch を fetch としてインポートし、package.json に node-fetch の依存関係も追加してください。

その他のオプション

🐳 Docker のデプロイ（本番環境）

本番環境にデプロイする場合は、Docker を使用できます。

1. Docker イメージをビルドする

docker build -t <your_server_name> .

2. Claude Desktop との統合

Docker サーバーの設定を Claude Desktop に追加します（Settings → Developers → Edit Config）。

{
  "mcpServers": {
    "<your_server_name>": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file=.env", "<your_server_name>"]
    }
  }
}

環境変数（API キーなど）は、.env ファイルに追加してください。

このプロジェクトには、以下の最小限の Docker セットアップが同梱されています。

FROM node:22.12-alpine AS builder

WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install

COPY . .

ENTRYPOINT ["node", "mcpServer.js"]

🌐 Server-Sent Events（SSE）

Server-Sent Events（SSE）に対応したサーバーを実行するには、--sse フラグを使用します。

node mcpServer.js --sse

🛠️ その他の CLI コマンド

ツールを一覧表示する

生成されたすべてのツールの説明とパラメーターを一覧表示するには、次のコマンドを実行します。

node index.js tools

例：

Available Tools:

Workspace: acme-workspace
  Collection: useful-api
    list_all_customers
      Description: Retrieve a list of useful things.
      Parameters:
        - magic: The required magic power
        - limit: Number of results returned
        [...additional parameters...]

➕ ツールを追加する

MCP サーバーには、次の手順で簡単にツールを追加できます。

1. Postman MCP Generator にアクセスします。
2. 新しい API リクエストを選択して、新しい MCP サーバーを生成し、ダウンロードします。
3. 新しく生成したツールを既存のプロジェクトの tools/ フォルダーにコピーします。
4. tools/paths.js ファイルを更新して、新しいツールへの参照を追加します。

💬 質問とサポート

最新情報や新機能については、Postman MCP Generator のページをご覧ください。

Postman Discord の #mcp-lab チャンネルに参加して、作成したものを共有したり、サポートを受けたりできます。