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