Advanced Backlog MCP Server

🚀 Backlog MCP サーバー

このサーバーは、Backlog（プロジェクト管理ツール）とのインタラクションを行うためのモデルコンテキストプロトコル (MCP) サーバーです。Backlog のリソース（プロジェクト、課題、ウィキ、ユーザーアクティビティなど）の照会と管理機能を提供します。

✨ 主な機能

• Backlog スペース情報の取得
• プロジェクトの一覧表示と検索
• 課題の検索、表示、管理
• ウィキページへのアクセス
• ユーザーアクティビティと通知の表示
• ユーザー情報の取得

📦 インストール

必要条件

• Node.js (v14 以上)
• API キー付きの Backlog アカウント

インストール手順

# リポジトリをクローン
git clone https://github.com/digitalcube/advanced-backlog-mcp-server.git
cd advanced-backlog-mcp-server

# 依存関係をインストール
npm install

# サーバーをビルド
npm run build

📚 ドキュメント

Claude デスクトップ設定

Backlog MCP サーバーを Claude Desktop と共に使用するには、以下の設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "advanced-backlog-mcp-server": {
      "command": "/path/to/advanced-backlog-mcp-server/build/index.js",
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

コマンドパスの取得

command フィールドに正しいパスを取得するには、ビルド後に以下のコマンドを実行します。

echo "\"$(pwd)/build/index.js\""

例: "/Users/username/development/mcp-servers/advanced-backlog-mcp-server/build/index.js"

macOS では、このパスを直接クリップボードにコピーできます。

echo "\"$(pwd)/build/index.js\"" | pbcopy

API キーの設定

API キーは、Backlog アカウント設定で取得できます。

💻 使用例

設定が完了したら、このサーバーを Claude Desktop または MCP 互換クライアントと共に使用できます。

Claude Desktop では、自然言語でのクエリが可能です。例えば：

• "最近のすべての課題を表示"
• "Backlog スペース内のすべてのプロジェクトを一覧表示"
• "自分に割り当てられた高優先度の課題を検索"

利用可能なツール

このサーバーは以下のツールを提供します。

• list_backlog_space - Backlog スペース情報の取得
• list_backlog_projects - Backlog スペース内のすべてのプロジェクトの一覧表示
• list_backlog_recently_viewed_issues - 最近表示した課題の一覧表示
• search_backlog_issues - 様々なフィルターを使用した課題の検索
• get_backlog_issue - 特定の課題の詳細情報の取得
• list_backlog_recently_viewed_projects - 最近表示したプロジェクトの一覧表示
• get_backlog_project - 特定のプロジェクトの詳細情報の取得
• list_backlog_recently_viewed_wikis - 最近表示したウィキページの一覧表示
• get_backlog_wiki - 特定のウィキの詳細情報の取得
• list_backlog_recent_user_activities - 特定のユーザーのアクティビティの一覧表示
• get_backlog_current_user - 現在のユーザーの情報の取得
• get_backlog_user - 特定のユーザーの情報の取得
• list_backlog_users - Backlog スペース内のすべてのユーザーの一覧表示
• list_backlog_own_notifications - 現在のユーザーの通知の一覧表示

デバッグ

MCP サーバーをデバッグするには、以下のコマンドを実行します。

npm run inspector

その後、ブラウザで生成された URL にアクセスします。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。