Bugherd MCP

🚀 BugHerd MCP Server

MCP（モデルコンテキストプロトコル）サーバーで、BugHerdのバグ追跡機能をAIアシスタントと統合します。

✨ 主な機能

すべてのリソースタイプにわたる38のツールを備えた、完全なBugHerd API v2カバレッジ：

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

📦 インストール

前提条件

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

セットアップ

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

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

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

bun install
# または
npm install

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

bun run build
# または
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)

組織

ユーザー

プロジェクト

タスク

カラム

コメント

添付ファイル

ウェブフック

プロジェクトとタスクの一覧表示

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"

ウェブフックの管理

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は、1分間に平均60回のリクエストを許可し、最大10回の連続リクエストを許容します。サーバーはレート制限エラーを適切に処理します。

📄 ライセンス

MIT

作者

Berckan Guerrero (hi@berck.io)

コントリビューション

コントリビューションは大歓迎です！ イシューを開くか、プルリクエストを送信してください。

関連情報

• BugHerd APIドキュメント
• モデルコンテキストプロトコル
• MCP TypeScript SDK