English Français العربية

io.github.Berckan/bugherd-mcp

السجل الرسمي أخرى

BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.Berckan/bugherd-mcp؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package bugherd-mcp
Claude Code 
claude mcp add bugherd-mcp -e 'BUGHERD_API_KEY=<your bugherd_api_key>' -- npx -y bugherd-mcp@0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bugherd-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "bugherd-mcp@0.2.0"
            ],
            "env": {
                "BUGHERD_API_KEY": "<your bugherd_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BUGHERD_API_KEY إلزامي سري BugHerd API key from Settings > General Settings

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. BugHerd MCP Server
  2. Features
  3. Installation
  4. Configuration
  5. Available Tools (37)
  6. Usage Examples
  7. Development
  8. API Rate Limits
  9. License
  10. Author
  11. Contributing
  12. Related

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
  1. Clone the repository:
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp
  1. Install dependencies:
bun install
# or
npm install
  1. Build the server:
bun run build
# or
npm run build
  1. 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
ToolDescription
bugherd_get_organizationGet organization/account details
Users
ToolDescription
bugherd_list_usersList all users (members + guests)
bugherd_list_membersList only team members
bugherd_list_guestsList only guests/clients
bugherd_get_user_tasksGet tasks assigned to a user
bugherd_get_user_projectsGet projects for a user
Projects
ToolDescription
bugherd_list_projectsList all projects
bugherd_list_active_projectsList only active projects
bugherd_get_projectGet project details
bugherd_create_projectCreate a new project
bugherd_update_projectUpdate project settings
bugherd_delete_project⚠️ Delete a project permanently
bugherd_add_memberAdd a member to a project
bugherd_add_guestAdd a guest to a project
Tasks
ToolDescription
bugherd_list_tasksList tasks with filters (status, priority, tag)
bugherd_list_feedback_tasksList unprocessed feedback tasks
bugherd_list_archived_tasksList archived tasks
bugherd_list_taskboard_tasksList taskboard tasks
bugherd_get_taskGet task details with metadata
bugherd_get_task_globalGet task by global ID
bugherd_get_task_by_local_idGet task by local ID (#123)
bugherd_create_taskCreate a new task
bugherd_move_tasksMove tasks between projects
bugherd_update_taskUpdate task status/priority/description/assignee
Columns
ToolDescription
bugherd_list_columnsList project columns (Kanban statuses)
bugherd_get_columnGet column details
bugherd_create_columnCreate a new column
bugherd_update_columnUpdate column name/position
Comments
ToolDescription
bugherd_list_commentsList comments on a task
bugherd_create_commentAdd a comment to a task
Attachments
ToolDescription
bugherd_list_attachmentsList task attachments
bugherd_get_attachmentGet attachment details
bugherd_create_attachmentCreate attachment from URL
bugherd_delete_attachment⚠️ Delete an attachment
Webhooks
ToolDescription
bugherd_list_webhooksList configured webhooks
bugherd_create_webhookCreate a webhook
bugherd_delete_webhook⚠️ Delete a webhook

Usage Examples

List projects and tasks
List my BugHerd projects
Show me all critical bugs in project 12345
Create and manage tasks
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"
Work with comments
Show comments on task 678 in project 12345
Add a comment to task 678: "Fixed in latest deploy"
Manage webhooks
List all webhooks
Create a webhook for task_create events pointing to https://example.com/webhook

Development

Run in development mode:
bun run dev
Test with MCP Inspector:
BUGHERD_API_KEY=xxx bun run inspector
Build for production:
bun run build

API Rate Limits

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.

License

MIT

Author

Berckan Guerrero

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

الأسئلة الشائعة

ما هو io.github.Berckan/bugherd-mcp؟

BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.

كيف أثبّت io.github.Berckan/bugherd-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add bugherd-mcp -e 'BUGHERD_API_KEY=<your bugherd_api_key>' -- npx -y bugherd-mcp@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Berckan/bugherd-mcp إلى مفتاح API؟

نعم. يتطلب BUGHERD_API_KEY، وتضبطها في إعداداته.

هل io.github.Berckan/bugherd-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Berckan/bugherd-mcp؟

ينشره Berckan. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.