Postman MCP サーバー

Newmanを使用してPostmanコレクションを実行できるMCP（Model Context Protocol）サーバー。このサーバーにより、LLMはAPIテストを実行し、標準化されたインターフェースを通じて詳細な結果を取得できます。

特徴

Newmanを使用してPostmanコレクションを実行する
環境ファイルのサポート
グローバル変数のサポート
詳細なテスト結果には以下が含まれます:
- 全体的な成功/失敗のステータス
- テストの概要（合計、合格、不合格）
- 詳細な障害情報
- 実行タイミング

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Postman Runner を自動的にインストールするには:

npx -y @smithery/cli install mcp-postman --client claude

手動インストール

# Clone the repository
git clone <repository-url>
cd mcp-postman

# Install dependencies
pnpm install

# Build the project
pnpm build

使用法

構成

~/Library/Application Support/Claude/claude_desktop_config.jsonにある Claude デスクトップ構成ファイルにサーバーを追加します。

{
  "mcpServers": {
    "postman-runner": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-postman/build/index.js"]
    }
  }
}

利用可能なツール

ランコレクション

Postman コレクションを実行し、テスト結果を返します。

パラメータ:

collection （必須）: PostmanコレクションへのパスまたはURL
environment （オプション）: 環境ファイルへのパスまたはURL
globals (オプション): グローバルファイルへのパスまたはURL
iterationCount (オプション): 実行する反復回数

応答例:

{
  "success": true,
  "summary": {
    "total": 5,
    "failed": 0,
    "passed": 5
  },
  "failures": [],
  "timings": {
    "started": "2024-03-14T10:00:00.000Z",
    "completed": "2024-03-14T10:00:01.000Z",
    "duration": 1000
  }
}

クロードでの使用例

Claude でサーバーを使用するには、Postman コレクションを実行するように要求します。

「/path/to/collection.json で Postman コレクションを実行し、すべてのテストに合格したかどうかを教えてください」

クロードは次のことを行います:

実行収集ツールを使用する
テスト結果を分析する
人間に分かりやすい実行概要を提供する

発達

プロジェクト構造

src/
  ├── index.ts           # Entry point
  ├── server/
  │   ├── server.ts     # MCP Server implementation
  │   └── types.ts      # Type definitions
  └── newman/
      └── runner.ts     # Newman runner implementation
test/
  ├── server.test.ts    # Server tests
  ├── newman-runner.test.ts  # Runner tests
  └── fixtures/         # Test fixtures
      └── sample-collection.json

テストの実行

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

建物

# Build the project
pnpm build

# Clean build artifacts
pnpm clean

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

ISC

Postman MCP Server

Integrations