Tmhr1850 Backlog MCP Server

🚀 Backlog MCP サーバー

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

✨ 主な機能

• プロジェクト管理：プロジェクトリストを取得し、プロジェクトの詳細情報を表示します。
• タスク管理：新しいタスクを作成し、既存のタスクを更新し、タスクを検索し、コメントを追加します。
• ユーザー管理：ユーザー情報を取得します。
• ファイル操作：添付ファイルを管理します。
• コメント機能：タスクにコメントを追加します。
• 検索機能：タスクまたはプロジェクトを検索します。

🛠️ ツール

プロジェクト関連

getSpaces

• スペース情報を取得します。
• 入力: なし
• 出力: スペース情報

getProjects

• プロジェクトリストを取得します。
• 入力: なし
• 出力: プロジェクトリスト

タスク関連

新しいタスクを作成する

• 入力:

  • title: タスクのタイトル（必須）
  • content: タスクの内容（オプション、デフォルトは空）
  • priority: 優先度（オプション、デフォルトは「中」）
  • assigneeId: 担当者の ID（オプション、指定しない場合はタスクは未割り当て）

• 出力: 新しいタスクの詳細情報

既存のタスクを更新する

• 入力:

  • taskId (必須): 更新するタスクの ID
  • title: 新しいタイトル（オプション）
  • content: 新しい内容（オプション）
  • priority: 新しい優先度（オプション）

• 出力: 更新後のタスクの詳細情報

タスクを検索する

• 入力:

  • keyword (必須): タスクのタイトルまたは内容を検索するためのキーワード
  • projectId (オプション): 特定のプロジェクトの ID
  • statusId (オプション): ステータス ID（例:「未完成」、「完了」）
  • assigneeId (オプション): 担当者の ID

• 出力: 条件に一致するタスクのリスト

コメントを追加する

• 入力:

  • taskId (必須): コメントを追加するタスクの ID
  • content (必須): コメントの内容

• 出力: 新しいコメントの詳細情報（生成されたコメント ID とタイムスタンプを含む）

⚙️ 設定

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