takuji/backlog-mcp-server-go

Backlog MCP Server (Go版)

BacklogのModel Context Protocol (MCP) サーバーのGo言語実装版です。TypeScript版からの移植です。

実装状況

✅ 完了した機能

基本機能 (6個)

• ✅ get_space - スペース情報の取得
• ✅ get_users - ユーザー一覧の取得
• ✅ get_projects - プロジェクト一覧の取得
• ✅ get_project - プロジェクト詳細の取得
• ✅ get_issues - 課題一覧の取得
• ✅ get_issue - 課題詳細の取得

追加機能 (7個)

• ✅ get_myself - 現在のユーザー情報取得
• ✅ get_issue_comments - 課題コメント取得
• ✅ get_issue_types - 課題種別取得
• ✅ get_priorities - 優先度取得
• ✅ get_categories - カテゴリ取得
• ✅ get_custom_fields - カスタムフィールド取得
• ✅ count_issues - 課題数カウント

プルリクエスト機能 (5個)

• ✅ get_pull_requests - プルリクエスト一覧取得
• ✅ get_pull_request - プルリクエスト詳細取得
• ✅ get_pull_request_comments - プルリクエストコメント取得
• ✅ get_git_repositories - Gitリポジトリ一覧取得
• ✅ get_git_repository - Gitリポジトリ詳細取得

通知・Wiki機能 (4個)

• ✅ get_notifications - 通知一覧取得
• ✅ get_notifications_count - 通知数取得
• ✅ get_wikis - Wiki一覧取得
• ✅ get_wiki - Wiki詳細取得

CRUD機能 (3個)

• ✅ add_issue - 課題作成
• ✅ add_issue_comment - 課題コメント追加
• ✅ update_issue - 課題更新

インフラストラクチャ

• ✅ 翻訳システム（日本語・英語対応）
• ✅ Backlog API クライアント
• ✅ MCP プロトコル実装
• ✅ ツール管理システム
• ✅ 設定管理

合計: 25個のツールを実装完了

Backlog API とやり取りするための Model Context Protocol（MCP）サーバーのGo言語実装です。Claude Desktop や Cline、Cursor などのAIエージェントを通じて、Backlog 上でプロジェクトや課題、Wikiページなどを操作するためのツールを提供します。

主な機能

• プロジェクト管理（作成、読み取り、更新、削除）
• 課題追跡（作成、更新、削除、一覧表示）
• Wiki ページ管理
• Git リポジトリ管理
• プルリクエスト管理（作成、更新、一覧表示、コメント）
• 通知管理
• ウォッチリスト管理
• GraphQLスタイルのフィールド選択による最適化されたレスポンス
• 大きなレスポンスのトークン制限
• 強化されたエラーハンドリング
• その他のBacklog API統合

必要条件

• Go 1.21以上
• Backlog アカウントと API アクセス権限
• Backlog アカウントからの API キー

インストール方法

バイナリからのインストール

1. リリースページから適切なバイナリをダウンロード
2. PATH に配置
3. 環境変数を設定してMCPサーバーとして設定

ソースからのビルド

git clone https://github.com/takuji/backlog-mcp-go.git
cd backlog-mcp-go
go build -o backlog-mcp-server ./cmd/server

設定

環境変数または設定ファイルで設定できます：

export BACKLOG_DOMAIN="your-domain.backlog.com"
export BACKLOG_API_KEY="your-api-key"
export MAX_TOKENS="50000"
export OPTIMIZE_RESPONSE="true"

使用方法

Claude Desktop での設定

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

開発

テスト実行

go test ./...

ビルド

go build -o backlog-mcp-server ./cmd/server

ライセンス

MIT License

謝辞

このプロジェクトは TypeScript で実装された元の backlog-mcp-server を Go 言語に移植したものです。