Postman MCP Server

Postman MCP サーバー

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

AI エージェントのリスト

機能

• 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"]
    }
  }
}

利用可能なツール

run-collection

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 コレクションを実行するよう依頼することで、Claude でサーバーを使用できます：

「/path/to/collection.json にある Postman コレクションを実行して、すべてのテストが成功したか教えてください」

Claude は次の処理を行います：

1. run-collection ツールを使用します
2. テスト結果を分析します
3. 実行結果をわかりやすく要約します

開発

プロジェクト構成

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

コントリビューション

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

ライセンス

ISC