Bruno MCP Server

Bruno MCP サーバー

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

機能

• Bruno CLI を使用して Bruno コレクションを実行
• 環境ファイルに対応
• 環境変数に対応
• 以下を含む詳細なテスト結果
  • 全体の成功／失敗ステータス
  • テストの概要（合計、成功、失敗）
  • 詳細な失敗情報
  • 実行時間

インストール

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop 用の Bruno MCP サーバーを自動的にインストールするには：

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

手動インストール

# Install dependencies
npm install

# Build the project
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 での使用例

Bruno コレクションを実行するよう依頼することで、Claude でこのサーバーを使用できます：

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

Claude は以下を行います：

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

開発

プロジェクト構成

src/
  ├── index.ts           # Entry point
  ├── server.ts          # MCP Server implementation
  ├── runner.ts          # Bruno runner implementation
  └── types.ts           # Type definitions

テストの実行

# Run tests
npm test

# Run tests with coverage
npm test:coverage

ビルド

# Build the project
npm run build

# Clean build artifacts
npm run clean

ライセンス

MIT