Bruno MCP

🚀 Bruno MCP 服務器

Bruno MCP 服務器是一個啟用運行 Bruno 集合的 MCP（模型上下文協議）服務器。它允許大型語言模型使用 Bruno 執行 API 測試，並通過標準接口獲取詳細的測試結果，為 API 測試提供了高效且便捷的解決方案。

🚀 快速開始

Bruno MCP 服務器可讓大型語言模型藉助 Bruno 執行 API 測試。你可以通過 Smithery 自動安裝，也能手動安裝。安裝完成後，進行簡單配置即可使用。

✨ 主要特性

• Bruno 集合運行：使用 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 許可證。