Bugherd Mcp

io.github.Berckan由 GitHub 帳號 Berckan 發布v0.2.0更新於 Oct 24, 2026

BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.

發布方自己的服務：BugHerd

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

非官方的本機 BugHerd 缺陷追蹤 MCP 伺服器，讓助理讀取與管理專案、任務、看板欄位、留言、附件與 Webhook。

可以做什麼
讀取組織與帳戶資訊，列出使用者、成員、訪客及其任務和專案。列出、建立、更新和刪除專案，並加入成員或訪客。列出、建立、移動和更新任務，包含回饋、已封存和任務板檢視。管理看板欄位，讀取或新增任務留言。列出、建立和刪除附件，以及列出、建立和刪除 Webhook。
適用情境
適合團隊以 BugHerd 收集網站回饋和缺陷時，讓助理在對話中查詢專案和任務、分流或更新問題、新增留言，或設定 Webhook。
執行需求
以 Node.js 18+ 或 Bun 本機程序執行，可從 npm 套件安裝或從原始碼建置。需要具備 API 存取權限的 BugHerd 帳戶，並透過 BUGHERD_API_KEY 環境變數提供 BugHerd API 金鑰。需要連線至 BugHerd API 的網路，並受其速率限制約束。
安裝前請注意
BUGHERD_API_KEY 中的 API 金鑰可存取 BugHerd 帳戶，應避免寫入共用設定。多個工具會寫入或刪除資料：建立和更新專案、任務、看板欄位、留言和 Webhook，以及永久刪除專案、附件和 Webhook。Webhook 會將事件資料傳送到你設定的外部網址。這是社群專案，並非 BugHerd 官方伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Bugherd Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

BugHerd MCP Server

Note: This is an unofficial, community-maintained, open-source (MIT) BugHerd MCP server. It runs locally, your data never leaves your machine. For BugHerd's official closed-source hosted server, see macropodhq/bugherd-mcp.

An MCP (Model Context Protocol) server that integrates BugHerd bug tracking with AI assistants.

Features

Complete BugHerd API v2 coverage with 38 tools across all resource types:

  • Organization - Get account details
  • Users - List members, guests, user tasks and projects
  • Projects - CRUD operations, manage members and guests
  • Tasks - Full task management including feedback, archived, and taskboard views
  • Columns - Custom Kanban board management
  • Comments - Read and create comments
  • Attachments - Manage file attachments
  • Webhooks - Configure event notifications

Installation

Prerequisites

  • Node.js 18+ or Bun
  • A BugHerd account with API access
  • BugHerd API key (get it from Settings > General Settings)

Setup

  1. Clone the repository:
bash
git clone https://github.com/berckan/bugherd-mcp.gitcd bugherd-mcp
  1. Install dependencies:
bash
bun install# ornpm install
  1. Build the server:
bash
bun run build# ornpm run build
  1. Set your API key:
bash
export BUGHERD_API_KEY=your-api-key-here

Configuration

CLI Configuration

Add to your MCP client config:

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

Desktop Apps

Add to your MCP desktop app config:

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

Available Tools (37)

Organization

ToolDescription
bugherd_get_organizationGet organization/account details

Users

ToolDescription
bugherd_list_usersList all users (members + guests)
bugherd_list_membersList only team members
bugherd_list_guestsList only guests/clients
bugherd_get_user_tasksGet tasks assigned to a user
bugherd_get_user_projectsGet projects for a user

Projects

ToolDescription
bugherd_list_projectsList all projects
bugherd_list_active_projectsList only active projects
bugherd_get_projectGet project details
bugherd_create_projectCreate a new project
bugherd_update_projectUpdate project settings
bugherd_delete_project⚠️ Delete a project permanently
bugherd_add_memberAdd a member to a project
bugherd_add_guestAdd a guest to a project

Tasks

ToolDescription
bugherd_list_tasksList tasks with filters (status, priority, tag)
bugherd_list_feedback_tasksList unprocessed feedback tasks
bugherd_list_archived_tasksList archived tasks
bugherd_list_taskboard_tasksList taskboard tasks
bugherd_get_taskGet task details with metadata
bugherd_get_task_globalGet task by global ID
bugherd_get_task_by_local_idGet task by local ID (#123)
bugherd_create_taskCreate a new task
bugherd_move_tasksMove tasks between projects
bugherd_update_taskUpdate task status/priority/description/assignee

Columns

ToolDescription
bugherd_list_columnsList project columns (Kanban statuses)
bugherd_get_columnGet column details
bugherd_create_columnCreate a new column
bugherd_update_columnUpdate column name/position

Comments

ToolDescription
bugherd_list_commentsList comments on a task
bugherd_create_commentAdd a comment to a task

Attachments

ToolDescription
bugherd_list_attachmentsList task attachments
bugherd_get_attachmentGet attachment details
bugherd_create_attachmentCreate attachment from URL
bugherd_delete_attachment⚠️ Delete an attachment

Webhooks

ToolDescription
bugherd_list_webhooksList configured webhooks
bugherd_create_webhookCreate a webhook
bugherd_delete_webhook⚠️ Delete a webhook

Usage Examples

List projects and tasks

List my BugHerd projectsShow me all critical bugs in project 12345

Create and manage tasks

Create a task in project 12345: "Fix the login button alignment"Move task 678 from project 12345 to project 67890Update task 678 status to "done"

Work with comments

Show comments on task 678 in project 12345Add a comment to task 678: "Fixed in latest deploy"

Manage webhooks

List all webhooksCreate a webhook for task_create events pointing to https://example.com/webhook

Development

Run in development mode:

bash
bun run dev

Test with MCP Inspector:

bash
BUGHERD_API_KEY=xxx bun run inspector

Build for production:

bash
bun run build

API Rate Limits

BugHerd allows an average of 60 requests per minute with bursts of up to 10 in quick succession. The server handles rate limiting errors gracefully.

License

MIT

Author

Berckan Guerrero

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Related

來源：README.md，提交 f9f0720

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Bugherd 整合

BugHerd

com.bugherd官方發布者

BugHerd 官方遠端 MCP 伺服器，透過 OAuth 登入後讓助理處理 BugHerd 的網站回饋與缺陷追蹤資料。

Streamable HTTP可網頁執行驗證方式
效率與工作流需要憑證Oct 29, 2026