# renpy-mcp

Ren'Py ビジュアルノベルプロジェクトを AI アシスタントから操作するための MCP (Model Context Protocol) サーバー。

## Tools

| Tool | 説明 |
|------|------|
| `renpy_create_project` | 新規 Ren'Py プロジェクトを作成 |
| `renpy_list_labels` | プロジェクト内の全ラベル一覧 |
| `renpy_list_characters` | Character 定義一覧 |
| `renpy_list_screens` | screen 定義一覧 |
| `renpy_add_label` | ラベルブロックを追記 |
| `renpy_add_character` | Character 定義を追加 |
| `renpy_validate` | .rpy 構文チェック（独自パーサー） |
| `renpy_summary` | プロジェクト概要 JSON |
| `renpy_run` | Ren'Py SDK で起動。`no_display=true` なら lint で検証 |
| `renpy_sdk_path` | SDK パス確認 |

## Setup

```bash
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
```

Ren'Py SDK の場所は環境変数 `RENPY_SDK` で指定するか、`~/renpy-*-sdk` を自動検出します。

## Run (stdio)

```bash
.venv/bin/python server.py
```

## opencode / claude での設定例

```json
{
  "mcp": {
    "renpy": {
      "command": "/home/bons/renpy-mcp/.venv/bin/python",
      "args": ["/home/bons/renpy-mcp/server.py"]
    }
  }
}
```

## 構成

- `server.py` - MCP サーバー本体（mcp SDK 2.x の `MCPServer` を使用）
- `rpy_parser.py` - 純 Python の .rpy パーサー（label / character / screen / transform / image 抽出）
- `standup-renpy-mcp-sdk.json` - 開発経緯を綴ったスタンドアップコメディ原稿