backlog-mcp-server

backlog-mcp-server

12

Provides an MCP server for accessing the Backlog API to manage projects, track issues, and handle files.

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 ファイルをご覧ください。