# EDCB MCP Server

EDCBをLLMから操作するためのMCPサーバー。番組情報取得、予約管理などが可能です。

## 前提

- EDCBがWebUIとともに起動していること
- Material WebUIがインストールされていること（`/EMWUI/`パスが有効であること）
- デフォルト接続先: `http://localhost:5510`

## ビルド

```bash
npm install
npm run build
```

## Claude Desktop 設定

`~/Library/Application Support/Claude/claude_desktop_config.json` に追加:

```json
{
  "mcpServers": {
    "edcb": {
      "command": "node",
      "args": ["/path/to/EDCB-MCPServer/dist/index.js"],
      "env": {
        "EDCB_URL": "http://192.168.1.x:5510"
      }
    }
  }
}
```

## 利用可能なツール

| ツール | 説明 |
|--------|------|
| `ping` | EDCBサーバーへの接続確認 |
| `get_services` | チャンネル一覧取得 |
| `get_epg` | 特定チャンネルの番組表取得 |
| `get_event_info` | 番組詳細取得 |
| `search_events` | キーワード番組検索 |
| `get_reserves` | 録画予約一覧取得 |
| `add_reserve` | 録画予約追加（デフォルトプリセット使用） |
| `set_reserve_enabled` | 録画予約の有効/無効切り替え |
| `delete_reserve` | 録画予約削除 |
| `change_reserve` | 録画予約設定変更 |
| `get_rec_info` | 録画済み番組一覧取得 |
| `get_auto_add` | 自動予約（EPGキーワード）一覧取得 |

## 使用例

自然言語でEDCBを操作できます。

### 番組を検索して予約

「推しの子」の最終話を自然言語で検索し、放送チャンネルを選んで録画予約。

![番組検索と予約](docs/images/スクリーンショット%202026-03-25%2016.44.28.png)

### 予約状況の確認

録画予約や自動予約の確認もチャット形式で行えます。

![予約確認](docs/images/スクリーンショット%202026-03-25%2016.45.47.png)

### EPGを使った番組検索

今後放送されるプロ野球の生中継一覧をEPGから検索して表示。

![EPG番組検索](docs/images/スクリーンショット%202026-03-25%2016.48.27.png)

### APIリファレンス

```
# チャンネル一覧（地上波のみ）
get_services(network="地上波")

# NHK総合の番組表を取得
get_epg(onid=32272, tsid=32272, sid=30720)

# 番組を予約
add_reserve(onid=32272, tsid=32272, sid=30720, eid=20202)

# 予約一覧確認
get_reserves()

# 予約を一時的に無効化（予約は残る）
set_reserve_enabled(id=2466, enabled=False)

# 予約を再度有効化
set_reserve_enabled(id=2466, enabled=True)

# 予約削除（取り消し不可）
delete_reserve(id=2466)
```

## 環境変数

| 変数 | デフォルト | 説明 |
|------|-----------|------|
| `EDCB_URL` | `http://localhost:5510` | EDCBサーバーのURL |