BugHerd MCP

BugHerd MCP服务器

一 MCP（模型上下文协议） 集成的服务器 BugHerd 使用AI助手进行错误跟踪。

特性

全面覆盖BugHerd API v2 在所有资源类型中有38个工具：

• 组织 -获取帐户详细信息
• 用户 -列出成员、客人、用户任务和项目
• 项目 -CRUD操作，管理会员和客人
• 任务 -完整的任务管理，包括反馈、存档和任务板视图
• 列 -定制看板管理
• 评论 -阅读并创建评论
• 附件 -管理文件附件
• 网络钩子 -配置事件通知

安装

先决条件

• Node.js 18+或Bun
• 具有API访问权限的BugHerd帐户
• BugHerd API密钥（从“设置”>“常规设置”获取）

设置

1. 克隆存储库：

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

1. 安装依赖项：

bun install
# or
npm install

1. 构建服务器：

bun run build
# or
npm run build

1. 设置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）

组织

用户

项目

任务

列

评论

附件

网络钩子

使用示例

列出项目和任务

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个请求。服务器优雅地处理速率限制错误。

许可证

麻省理工学院

作者

贝尔坎 格雷罗 (hi@berck.io)

贡献

欢迎投稿！请打开问题或提交拉取请求。

相关

• BugHerd API文档
• 模型上下文协议
• MCP TypeScript SDK