使用说明
BugHerd MCP服务器
注： 这是一个非官方的、由社区维护的开源（MIT）BugHerd MCP服务器。它在本地运行，您的数据永远不会离开您的机器。有关BugHerd的官方闭源托管服务器，请参阅 macropodhq/bugherd mcp.
一 MCP（模型上下文协议） 集成的服务器 BugHerd 使用AI助手进行错误跟踪。
特性
全面覆盖BugHerd API v2 在所有资源类型中有38个工具：
- 组织 -获取帐户详细信息
- 用户 -列出成员、客人、用户任务和项目
- 项目 -CRUD操作，管理会员和客人
- 任务 -完整的任务管理，包括反馈、存档和任务板视图
- 列 -定制看板管理
- 评论 -阅读并创建评论
- 附件 -管理文件附件
- 网络钩子 -配置事件通知
安装
先决条件
- Node.js 18+或Bun
- 具有API访问权限的BugHerd帐户
- BugHerd API密钥（从“设置”>“常规设置”获取）
设置
- 克隆存储库：
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp
- 安装依赖项：
bun install
# or
npm install
- 构建服务器：
bun run build
# or
npm run build
- 设置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 |
⚠️ 删除附件 |
网络钩子
| 工具 | 说明 |
|---|---|
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"
管理webhooks
List all webhooks
Create a webhook for task_create events pointing to https://example.com/webhook
发展
在开发模式下运行：
bun run dev
MCP检验员测试：
BUGHERD_API_KEY=xxx bun run inspector
生产建设：
bun run build
API费率限制
BugHerd允许平均每分钟60个请求，快速连续最多10个请求。服务器优雅地处理速率限制错误。
许可证
麻省理工学院
作者
贡献
欢迎投稿！请打开问题或提交拉取请求。
