BugHerd MCP Server 是一个基于 Model Context Protocol（MCP）的服务器，用于将 BugHerd 缺陷跟踪工具与 AI 助手（如 Claude）集成。该项目为非官方、社区维护的开源项目，采用 MIT 许可证，在本地运行，数据不会离开用户机器。
用途：通过 MCP 协议，让 AI 助手能够直接操作 BugHerd 的缺陷与反馈管理功能，例如列出项目、过滤任务、查看任务详情、读取和创建评论等。
主要能力：服务器覆盖 BugHerd API v2，提供 38 个工具，涵盖以下资源类型：
- 组织：获取账户详情
- 用户：列出成员、访客、用户任务和项目
- 项目：CRUD 操作，管理成员和访客
- 任务：完整的任务管理，包括反馈、归档和任务板视图
- 列：自定义看板管理
- 评论：读取和创建评论
- 附件：管理文件附件
- Webhooks：配置事件通知
使用方式：
- 前置条件：Node.js 18+ 或 Bun；拥有 API 访问权限的 BugHerd 账户；BugHerd API 密钥（从 Settings > General Settings 获取）。
- 安装：克隆仓库、安装依赖、构建服务器、设置 API 密钥。
- 配置：添加到 MCP 客户端配置或 MCP 桌面应用配置中。
- 开发与测试：支持开发模式运行，可使用 MCP Inspector 测试。
- 生产构建：构建后用于生产环境。
适用场景：适用于需要在 AI 助手中直接管理 BugHerd 缺陷和反馈的团队或个人，例如通过 Claude 快速查询项目任务、按状态或优先级筛选任务、查看评论等。
限制：
- 该服务器为非官方社区项目，非 BugHerd 官方托管服务器。官方闭源托管服务器请参见 macropodhq/bugherd-mcp。
- BugHerd API 有速率限制：平均每分钟 60 个请求，快速连续请求最多 10 个。服务器会优雅地处理速率限制错误。
- 需要 BugHerd 账户和 API 密钥，且账户需具备 API 访问权限。
- 运行环境需 Node.js 18+ 或 Bun。
