
berckan/bugherd-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP server for BugHerd integration - manage bugs and feedback from Claude
개요
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. with 38 tools across all resource types: - - Get account details - - List members, guests, user tasks and projects - - CRUD operations, manage members and guests - - Full task management including feedback, archived, and taskboard views - - Custom Kanban board management - - Read and create comments - - Manage file attachments - - Configure event notifications - Node.js 18+ or Bun - A BugHerd account with API access - BugHerd API key (get it from Settings > General Settings) 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. Contributions are welcome!
README
원문 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
- Clone the repository:
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp
- Install dependencies:
bun install
# or
npm install
- Build the server:
bun run build
# or
npm run build
- Set your API key:
export BUGHERD_API_KEY=your-api-key-here
Configuration
CLI Configuration
Add to your MCP client config:
{
"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:
{
"mcpServers": {
"bugherd": {
"command": "node",
"args": ["/path/to/bugherd-mcp/dist/index.js"],
"env": {
"BUGHERD_API_KEY": "your-api-key-here"
}
}
}
}
Available Tools (37)
Organization
| Tool | Description |
|---|---|
bugherd_get_organization |
Get organization/account details |
Users
| Tool | Description |
|---|---|
bugherd_list_users |
List all users (members + guests) |
bugherd_list_members |
List only team members |
bugherd_list_guests |
List only guests/clients |
bugherd_get_user_tasks |
Get tasks assigned to a user |
bugherd_get_user_projects |
Get projects for a user |
Projects
| Tool | Description |
|---|---|
bugherd_list_projects |
List all projects |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"bugherd": {
"type": "stdio",
"command": "node",
"args": ["/path/to/bugherd-mcp/dist/index.js"],
"env": {
"BUGHERD_API_KEY": "your-api-key-here"
}
}
}
}