Skip to main content
Glama
giovannicocco

Postman Tool Generation MCP Server

Postmanツール生成MCPサーバー

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

モデルコンテキストプロトコル(MCP)は、大規模言語モデル(LLM)と外部システム間のコンテキストを管理するための新しい標準化プロトコルです。このリポジトリでは、 Postmanツール生成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) のサポート

  • 型安全なコード生成

  • エラー処理と応答検証

Related MCP server: Postman MCP Generator

デモ

設定

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

npm install
  1. サーバーを構築します。

npm run build
  1. 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
  1. src/index.tsに変更を加える

  2. サーバーを構築します。

npm run build
  1. 更新されたサーバーをロードするには、Claudeアプリを再起動してください。

環境変数

  • POSTMAN_API_KEY : Postman API キー(必須)

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

  • 無効なパラメータ

  • API障害

  • JSON解析エラー

  • ネットワークの問題

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

貢献

貢献を歓迎します!お気軽にプルリクエストを送信してください。

ライセンス

MITライセンス

Available Tools

1 tool
generate_ai_toolB

Generate code for an AI agent tool using a Postman collection and request

ParametersJSON Schema
NameRequiredDescriptionDefault
collectionIdYesThe Public API Network collection ID
requestIdYesThe public request ID
languageYesProgramming language to use
agentFrameworkYesAI agent framework to use

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool 'generate[s] code' but does not clarify aspects like whether this is a read-only operation, if it requires authentication, potential side effects, or output format. This leaves significant gaps in understanding the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that efficiently conveys the tool's purpose without unnecessary words. It is front-loaded and every part of the sentence contributes directly to understanding, making it highly concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a code generation tool with no annotations and no output schema, the description is insufficient. It lacks details on what the generated code includes, how it handles errors, or the format of the output, leaving the agent with incomplete information to use the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so the input schema already documents all parameters thoroughly. The description adds no additional meaning beyond what the schema provides, such as examples or usage context for the parameters. This meets the baseline for high schema coverage but does not enhance parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with specific verbs ('generate code') and resources ('AI agent tool'), specifying the input sources ('Postman collection and request'). It distinguishes what the tool does without ambiguity, making it immediately understandable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by mentioning the input sources (Postman collection and request), but it does not provide explicit guidance on when to use this tool versus alternatives, prerequisites, or exclusions. Since there are no sibling tools, the lack of comparative guidance is less critical, but it still lacks detailed context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedgenerate_ai_tool

TDQS

B3.4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap with other tools. The tool's purpose is clearly defined and distinct by default.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tools to compare it against for patterns or conventions.

Tool Count2/5

One tool is too few for the server's stated purpose of 'Postman Tool Generation,' which implies a broader scope like generating, managing, or testing tools. A single generation tool feels thin and incomplete for this domain.

Completeness2/5

The tool surface is severely incomplete for the inferred domain of Postman-based tool generation. There are obvious gaps, such as no tools for listing, editing, deleting, or testing generated tools, which limits agent workflows to a single action.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Automatically converts Postman API collections into MCP-compatible tools for AI assistants. Enables users to interact with any API through natural language by generating JavaScript tools from Postman requests.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Generates MCP servers from Postman API requests, automatically creating JavaScript tools that enable LLMs to interact with any API documented in Postman collections. Supports authentication configuration and deployment via STDIO or SSE.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that converts Postman API requests into executable tools for LLMs using the Postman Runtime. It supports complex authentication types and enables seamless integration between Postman collections and MCP clients like Claude Desktop.
    -
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides seamless integration with the Postman API, enabling AI assistants and applications to interact with Postman workspaces, collections, requests, environments, and folders programmatically.
    19
    15 npm
    31
    MIT