Bugherd MCP

🚀 BugHerd MCP 服務器

這是一個 MCP（模型上下文協議） 服務器，它將 BugHerd 缺陷跟蹤系統與人工智能助手集成在一起，為用戶提供更高效的缺陷管理體驗。

🚀 快速開始

BugHerd MCP 服務器集成了 BugHerd 缺陷跟蹤系統和 AI 助手。要使用該服務器，你需要完成安裝和配置步驟，以下是詳細說明。

✨ 主要特性

全面覆蓋 BugHerd API v2，提供涵蓋所有資源類型的 38 種工具：

• 組織管理：獲取賬戶詳細信息
• 用戶管理：列出成員、訪客、用戶任務和項目
• 項目管理：支持項目的增刪改查操作，管理成員和訪客
• 任務管理：提供完整的任務管理功能，包括反饋、存檔和任務板視圖
• 列管理：自定義看板管理
• 評論管理：讀取和創建評論
• 附件管理：管理文件附件
• Webhook 配置：配置事件通知

📦 安裝指南

前提條件

• Node.js 18 及以上版本或 Bun
• 擁有具備 API 訪問權限的 BugHerd 賬戶
• BugHerd API 密鑰（可從“設置”>“常規設置”中獲取）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp

2. 安裝依賴：

bun install
# 或者
npm install

3. 構建服務器：

bun run build
# 或者
npm run build

4. 設置 API 密鑰：

export BUGHERD_API_KEY=your-api-key-here

📚 詳細文檔

配置說明

CLI 配置

將以下內容添加到你的 MCP 客戶端配置中：

{
  "mcpServers": {
    "bugherd": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/bugherd-mcp/dist/index.js"],
      "env": {
        "BUGHERD_API_KEY": "your-api-key-here"
      }
    }
  }
}

桌面應用配置

將以下內容添加到你的 MCP 桌面應用配置中：

{
  "mcpServers": {
    "bugherd": {
      "command": "node",
      "args": ["/path/to/bugherd-mcp/dist/index.js"],
      "env": {
        "BUGHERD_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具（37 種）

組織管理

用戶管理

項目管理

任務管理

列管理

評論管理

附件管理

Webhook 管理

💻 使用示例

列出項目和任務

列出我的 BugHerd 項目
顯示項目 12345 中的所有關鍵缺陷

創建和管理任務

在項目 12345 中創建任務：“修復登錄按鈕對齊問題”
將任務 678 從項目 12345 移動到項目 67890
將任務 678 的狀態更新為“已完成”

處理評論

顯示項目 12345 中任務 678 的評論
向任務 678 添加評論：“在最新部署中已修復”

管理 Webhook

列出所有 Webhook
為 task_create 事件創建一個指向 https://example.com/webhook 的 Webhook

🔧 技術細節

開發模式運行

bun run dev

使用 MCP 檢查器進行測試

BUGHERD_API_KEY=xxx bun run inspector

生產環境構建

bun run build

API 速率限制

BugHerd 允許平均每分鐘 60 個請求，短時間內最多可連續發送 10 個請求。服務器能夠優雅地處理速率限制錯誤。

📄 許可證

本項目採用 MIT 許可證。

👨‍💻 作者

Berckan Guerrero (hi@berck.io)

🤝 貢獻

歡迎貢獻代碼！請提交問題或拉取請求。

🔗 相關鏈接

• BugHerd API 文檔
• 模型上下文協議
• MCP TypeScript SDK