hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows running Postman collections using Newman, executing API tests and getting detailed results through a standardized interface

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

run-collection

Newman を使用して Postman コレクションを実行し、API テストを実行し、標準化されたインターフェースを介して詳細な結果分析を取得できるようにします。

Related Resources

Reddit Discussion about this server

Postman MCP Server