bugherd-mcp

BugHerd MCP サーバー

**注記：**これは非公式のコミュニティ運営によるオープンソース（MIT）の BugHerd MCP サーバーです。ローカルで動作し、データがマシンの外に出ることはありません。BugHerd の公式クローズドソースホスト型サーバーについては、macropodhq/bugherd-mcpをご覧ください。

BugHerdのバグ追跡機能と AI アシスタントを連携するMCP（Model Context Protocol）サーバーです。

機能

すべてのリソースタイプにわたる38個のツールで、BugHerd API v2 を完全にカバーします。

• 組織 - アカウントの詳細を取得
• ユーザー - メンバー、ゲスト、ユーザーのタスクとプロジェクトを一覧表示
• プロジェクト - CRUD 操作、メンバーとゲストの管理
• タスク - フィードバック、アーカイブ済みタスク、タスクボード表示を含む、完全なタスク管理
• 列 - カスタム Kanban ボードの管理
• コメント - コメントの読み取りと作成
• 添付ファイル - ファイル添付の管理
• Webhook - イベント通知の設定

インストール

前提条件

• Node.js 18+ または Bun
• API アクセスが可能な BugHerd アカウント
• BugHerd API キー（Settings > General Settings から取得）

セットアップ

1. リポジトリをクローンします。

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

2. 依存関係をインストールします。

bun install
# or
npm install

3. サーバーをビルドします。

bun run build
# or
npm run build

4. 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	⚠️ 添付ファイルを削除します

Webhook

ツール	説明
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"

Webhook を管理する

List all webhooks
Create a webhook for task_create events pointing to https://example.com/webhook

開発

開発モードで実行する：

bun run dev

MCP Inspector でテストする：

BUGHERD_API_KEY=xxx bun run inspector

本番環境向けにビルドする：

bun run build

API のレート制限

BugHerd では、1 分あたり平均 60 件のリクエストが許可され、短時間に最大 10 件を連続して送信できます。サーバーはレート制限エラーを適切に処理します。

ライセンス

MIT

作者

Berckan Guerrero

コントリビューション

コントリビューションを歓迎します！Issue を作成するか、プルリクエストを送信してください。

関連リンク

• BugHerd API ドキュメント
• Model Context Protocol
• MCP TypeScript SDK