mcpserver.so LogoMCPFly
Submit
Backlog MCP Server logo

Backlog MCP Server

by tmhr1850

Productivity/Task & Project ManagementBacklogAPIProject ManagementIssue Tracking

The Backlog MCP server provides access to the Backlog API. It allows you to utilize functionalities such as project management, issue tracking, and file operations.

View on GitHub

Last updated: N/A

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