Backlog MCP サーバー

Backlog API へのアクセスを提供する MCP サーバーです。プロジェクト管理、課題追跡、ファイル操作などの機能を利用できます。

機能

• プロジェクト管理: プロジェクト一覧の取得、詳細情報の閲覧
• 課題管理: 課題の作成、更新、検索、コメント追加
• ユーザー管理: ユーザー情報の取得
• ファイル操作: 添付ファイルの管理
• コメント機能: 課題へのコメント追加
• 検索機能: 課題やプロジェクトの検索

ツール

プロジェクト関連

getSpaces

• スペース情報を取得します
• 入力: なし
• 戻り値: スペース情報

getProjects

• プロジェクト一覧を取得します
• 入力: なし
• 戻り値: プロジェクト一覧

課題関連

getIssues

• 課題一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクト ID またはキー
  • offset (number, オプション): 取得開始位置
  • count (number, オプション): 取得件数（最大 100）
  • sort (string, オプション): ソート順 ('created'または'updated')
  • order (string, オプション): ソート方向 ('asc'または'desc')
• 戻り値: 課題一覧

getIssue

• 課題の詳細情報を取得します
• 入力:
  • issueIdOrKey (string): 課題 ID またはキー
• 戻り値: 課題の詳細情報

createIssue

• 新しい課題を作成します
• 入力:
  • projectId (string/number): プロジェクト ID
  • summary (string): 課題の件名
  • issueTypeId (string/number): 課題種別 ID
  • priorityId (string/number, オプション): 優先度 ID
  • description (string, オプション): 課題の詳細
  • startDate (string, オプション): 開始日 (YYYY-MM-DD 形式)
  • dueDate (string, オプション): 期限日 (YYYY-MM-DD 形式)
  • assigneeId (string/number, オプション): 担当者 ID
• 戻り値: 作成された課題の情報

updateIssue

• 既存の課題を更新します
• 入力:
  • issueIdOrKey (string): 課題 ID またはキー
  • summary (string, オプション): 課題の件名
  • description (string, オプション): 課題の詳細
  • statusId (string/number, オプション): 状態 ID
  • priorityId (string/number, オプション): 優先度 ID
  • assigneeId (string/number, オプション): 担当者 ID
  • startDate (string, オプション): 開始日 (YYYY-MM-DD 形式)
  • dueDate (string, オプション): 期限日 (YYYY-MM-DD 形式)
• 戻り値: 更新された課題の情報

addComment

• 課題にコメントを追加します
• 入力:
  • issueIdOrKey (string): 課題 ID またはキー
  • content (string): コメント内容
• 戻り値: 追加されたコメントの情報

検索関連

searchIssues

• 課題を検索します
• 入力:
  • keyword (string): 検索キーワード
  • projectIdOrKey (string, オプション): プロジェクト ID またはキー
  • offset (number, オプション): 取得開始位置
  • count (number, オプション): 取得件数（最大 100）
• 戻り値: 検索結果の課題一覧

検索構文

課題検索

• keyword: フリーテキスト検索
• projectId: 特定のプロジェクトで絞り込み
• statusId: 状態で絞り込み
• assigneeId: 担当者で絞り込み

例: keyword=バグ statusId=1 assigneeId=12345

セットアップ

API キーの取得

1. Backlog にログイン
2. 個人設定 > API > API キーの発行
3. 発行された API キーをコピー

環境変数の設定

.envファイルに以下の設定を追加します:

BACKLOG_DOMAIN=your-domain.backlog.com
BACKLOG_API_KEY=your-api-key

# テスト用設定（オプション）
TEST_PROJECT_ID=your-test-project-id
TEST_PROJECT_KEY=your-test-project-key

Claude Desktop での使用

Claude Desktop で使用するには、claude_desktop_config.jsonに以下を追加します:

NPX の場合

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": ["-y", "@tmhr1850/backlog-mcp-server"],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル実行

# ビルド
npm run build

# 実行
npm start

テスト

# 全テスト実行
npm test

# 監視モードでテスト実行
npm run test:watch

# カバレッジレポート付きでテスト実行
npm run test:coverage

ライセンス

この MCP サーバーは MIT ライセンスの下で提供されています。詳細はプロジェクトリポジトリの LICENSE ファイルをご覧ください。