Bruno MCP

🚀 Bruno MCP サーバ

Brunoコレクションを実行するためのMCP（モデルコンテキストプロトコル）サーバです。このサーバを使用すると、大規模言語モデルがBrunoを使ってAPIテストを実行し、標準インターフェースを通じて詳細なテスト結果を取得できます。

✨ 主な機能

• Bruno CLIを使用してBrunoコレクションを実行する
• 環境ファイルをサポートする
• 環境変数をサポートする
• 詳細なテスト結果を提供する：
  • 全体的な成功/失敗のステータス
  • テストの概要（総数、合格数、不合格数）
  • 詳細な失敗情報
  • 実行時間

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて自動的にBruno MCP Serverをインストールします：

npx -y @smithery/cli install @hungthai1401/bruno-mcp --client claude

手動インストール

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

📚 ドキュメント

設定

サーバをClaudeデスクトップの設定ファイル~/Library/Application Support/Claude/claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "bruno-runner": {
      "command": "npx",
      "args": ["-y", "bruno-mcp"],
    }
  }
}

利用可能なツール

run-collection

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

パラメータ:

• collection（必須）：Brunoコレクションのパス
• environment（オプション）：環境ファイルのパス
• variables（オプション）：キーと値のペア形式の環境変数

応答例:

{
  "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での使用例

Claudeでこのサーバを使用してBrunoコレクションを実行するには、以下のように操作します：

「/path/to/collection.bruにあるBrunoコレクションを実行し、すべてのテストが合格したかどうかを教えて」

Claudeは以下のことを行います：

1. run-collectionツールを使用する
2. テスト結果を分析する
3. 実行の人間が読める概要を提供する

🔧 技術詳細

プロジェクト構造

src/
  ├── index.ts           # エントリポイント
  ├── server.ts          # MCPサーバの実装
  ├── runner.ts          # Brunoランナーの実装
  └── types.ts           # 型定義

テストの実行

# テストを実行する
npm test

# コードカバレッジ付きのテスト
npm test:coverage

ビルド

# プロジェクトをビルドする
npm run build

# ビルドファイルをクリーンアップする
npm run clean

📄 ライセンス

MIT