Backlog MCP Qsd

🚀 Backlog MCP サーバー

Backlog インターフェースをサポートする MCP（Message Communication Proxy）サーバーです。このサーバーは、Backlog の様々な機能を操作するためのインターフェースを提供し、プロジェクト管理やタスク管理などの作業を効率化します。

✨ 主な機能

サポート機能

• プロジェクト管理：プロジェクトに関連する情報を取得します。
• タスク管理：タスクの操作（作成、更新、削除など）を行います。
• 検索機能：条件に基づいてタスクを絞り込みます。
• 状態管理：プロジェクトの状態に関連する操作を処理します。
• ユーザー情報：ユーザーのプロファイルを取得します。

サポートされる Backlog バージョン

• Standard Plan
• Professional Plan

📚 ドキュメント

プロジェクト関連ツール

getSpaces

• 機能：利用可能なスペース（プロジェクト）のリストを取得します。
• 入力：なし
• 出力：スペース情報を含むデータ構造を返します。

getProjects

• 機能：特定のスペース内のすべてのプロジェクトを取得します。
• 入力：スペース ID または名前を指定します。
• 出力：指定されたスペース内のプロジェクトのリストを返します。

タスク関連ツール

createIssue

• 機能：新しいタスクを作成します。
• 入力：タスクのタイトル、内容、優先度などのパラメータを指定します。
• 出力：新しく作成されたタスクの詳細情報を返します。

updateIssue

• 機能：既存のタスクの情報を更新します。
• 入力：タスク ID と変更するフィールドを指定します。
• 出力：更新後のタスクの詳細情報を返します。

deleteIssue

• 機能：指定されたタスクを削除します。
• 入力：タスク ID を指定します。
• 出力：削除が成功したことを確認するステータスを返します。

検索関連ツール

searchIssues

• 機能：条件に基づいてタスクを検索します。
• 入力：キーワード、プロジェクト ID、状態 ID、担当者 ID などのフィルタ条件を指定します。
• 出力：フィルタ条件に一致するタスクのリストを返します。

📦 インストール

環境変数の設定

.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_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 ファイルを参照してください。