bugherd-mcp

BugHerd MCP 服务

**注意：**这是一个非官方、由社区维护的开源（MIT）BugHerd MCP 服务。它在本地运行，你的数据不会离开你的设备。如需使用 BugHerd 官方闭源托管服务，请参阅 macropodhq/bugherd-mcp。

一个用于将 BugHerd 错误跟踪与 AI 助手集成的 MCP（Model Context Protocol） 服务。

功能

完整覆盖 BugHerd API v2，涵盖所有资源类型，共有 38 个工具：

• 组织 - 获取账户详情
• 用户 - 列出成员、访客、用户任务和项目
• 项目 - CRUD 操作，管理成员和访客
• 任务 - 完整的任务管理，包括反馈、已归档任务和任务看板视图
• 列 - 管理自定义 Kanban 看板
• 评论 - 查看和创建评论
• 附件 - 管理文件附件
• Webhook - 配置事件通知

安装

前置条件

• Node.js 18+ 或 Bun
• 可使用 API 的 BugHerd 账户
• BugHerd API 密钥（从 Settings > General Settings 获取）

设置

1. 克隆代码库：

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

2. 安装依赖项：

bun install
# or
npm install

3. 构建服务：

bun run build
# or
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 个）

组织

工具	描述
bugherd_get_organization	获取组织/账户详情

用户

工具	描述
bugherd_list_users	列出所有用户（成员 + 访客）
bugherd_list_members	仅列出团队成员
bugherd_list_guests	仅列出访客/客户
bugherd_get_user_tasks	获取分配给某用户的任务
bugherd_get_user_projects	获取某用户的项目

项目

工具	描述
bugherd_list_projects	列出所有项目
bugherd_list_active_projects	仅列出活跃项目
bugherd_get_project	获取项目详情
bugherd_create_project	创建新项目
bugherd_update_project	更新项目设置
bugherd_delete_project	⚠️ 永久删除项目
bugherd_add_member	将成员添加到项目
bugherd_add_guest	将访客添加到项目

任务

工具	描述
bugherd_list_tasks	使用筛选条件（状态、优先级、标签）列出任务
bugherd_list_feedback_tasks	列出尚未处理的反馈任务
bugherd_list_archived_tasks	列出已归档任务
bugherd_list_taskboard_tasks	列出任务看板任务
bugherd_get_task	获取包含元数据的任务详情
bugherd_get_task_global	根据全局 ID 获取任务
bugherd_get_task_by_local_id	根据本地 ID 获取任务（#123）
bugherd_create_task	创建新任务
bugherd_move_tasks	在项目之间移动任务
bugherd_update_task	更新任务状态/优先级/描述/受派人

列

工具	描述
bugherd_list_columns	列出项目列（看板状态）
bugherd_get_column	获取列详情
bugherd_create_column	创建新列
bugherd_update_column	更新列名称/位置

评论

工具	描述
bugherd_list_comments	列出任务评论
bugherd_create_comment	为任务添加评论

附件

工具	描述
bugherd_list_attachments	列出任务附件
bugherd_get_attachment	获取附件详情
bugherd_create_attachment	从 URL 创建附件
bugherd_delete_attachment	⚠️ 删除附件

Webhook

工具	描述
bugherd_list_webhooks	列出已配置的 Webhook
bugherd_create_webhook	创建 Webhook
bugherd_delete_webhook	⚠️ 删除 Webhook

使用示例

列出项目和任务

List my BugHerd projects
Show me all critical bugs in project 12345

创建和管理任务

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

使用评论

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

管理 Webhook

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

开发

在开发模式下运行：

bun run dev

使用 MCP Inspector 测试：

BUGHERD_API_KEY=xxx bun run inspector

构建生产版本：

bun run build

API 速率限制

BugHerd 平均每分钟允许 60 个请求，短时间内最多可连续发送 10 个请求。服务端会妥善处理速率限制错误。

许可证

MIT

作者

Berckan Guerrero

贡献

欢迎贡献！请提交 issue 或 pull request。

相关资源

• BugHerd API 文档
• Model Context Protocol
• MCP TypeScript SDK