# bgl-mcp-server

[bgl](https://github.com/dannygim/bgl) CLIをラップしたMCPサーバーです。

VSCode + GitHub Copilot や Claude Desktop から、直接Backlogの課題を参照・コメント追加ができるようになります。

## 前提条件

- Node.js v20以上
- bgl がインストール済み＆ログイン済み

```bash
# bglのインストール（まだの場合）
brew tap dannygim/tap
brew install bgl

# Backlogにログイン
bgl auth login
```

## インストール

```bash
# リポジトリをクローン
git clone <this-repo>
cd bgl-mcp-server

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

# ビルド
npm run build
```

## VSCode + GitHub Copilot での設定

プロジェクトの `.vscode/mcp.json` を作成：

```json
{
  "servers": {
    "backlog": {
      "command": "node",
      "args": ["/path/to/bgl-mcp-server/dist/index.js"]
    }
  }
}
```

または、グローバル設定 `~/.vscode/mcp.json` に追加。

## Claude Desktop での設定

`~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "backlog": {
      "command": "node",
      "args": ["/path/to/bgl-mcp-server/dist/index.js"]
    }
  }
}
```

## 利用可能なツール

| ツール名 | 説明 |
|---------|------|
| `backlog_get_issue` | 課題の内容を取得 |
| `backlog_get_comments` | 課題のコメント一覧を取得 |
| `backlog_add_comment` | 課題にコメントを追加 |

## 使い方の例

Copilot Chatで以下のように話しかけるだけ：

```
EBC_101-25956 の課題内容を確認して
```

```
この課題の原因を分析して、修正方針を検討して
```

```
検討した修正方針をBacklogにコメントとして投稿して
```

## ライセンス

MIT