MMCPMarkets
BB

berckan/bugherd-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

7 stars 5 forks 质量 73 趋势 19MIT
Repository Install

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

  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

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
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "bugherd": { "type": "stdio", "command": "node", "args": ["/path/to/bugherd-mcp/dist/index.js"], "env": { "BUGHERD_API_KEY": "your-api-key-here" } } } }