Korean | 한국어

、communicate 웹사이트:https://space.bilibili.com/341162425?spm_id_from=333.788.0.0 이메일:[email protected]

---

한국어

MCP (Model Context Protocol) 서버는 Ren’Py Visual 소설 프로젝트와 상호 작용할 수 있게 해주며, 스크립트를 읽고, 코드를 주입하고, 모든 것을 자동으로 검증합니다.

FastMCP로 내장.

왜?

Ren’Py는 내장 편집기가 없습니다. 개발자는 수동으로 .rpy 텍스트 파일을 작성하고 테스트하려면 "Launch Project"를 클릭하십시오. 이 MCP는 네이티브 Ren’Py 개발 조수로 AI 에이전트 (Claude, OpenCode, OpenClaw 등)를 전환합니다. 당신은 자연 언어로 원하는 것을 설명합니다. AI는 유효한 Ren’Py 스크립트를 작성하고 올바른 위치에 삽입하고 자동 컴파일을 확인합니다.

도구

Ren’Py MCP Server

English | 中文

联络网址、communicate website：https://space.bilibili.com/341162425?spm_id_from=333.788.0.0 email：[email protected]

---

English

An MCP (Model Context Protocol) server that lets AI agents interact with Ren’Py visual novel projects — read scripts, inject code, and validate everything automatically.

Built with FastMCP.

Why?

Ren’Py has no built-in editor. Developers manually write .rpy text files and click “Launch Project” to test. This MCP turns any AI agent (Claude, OpenCode,OpenClaw etc.) into a native Ren’Py development assistant — you describe what you want in natural language, the AI writes valid Ren’Py script, inserts it at the right location, and auto-compiles to verify.

Tools

Quick Start

# Clone
git clone https://github.com/Muanchen2/renpy-mcp.git
cd renpy-mcp

# Install
python -m venv .venv
.venv\Scripts\pip install -e .

# Run
.venv\Scripts\python -m renpy_mcp.server

MCP Config

Add to ~/.workbuddy/mcp.json:

{
  "mcpServers": {
    "renpy-mcp": {
      "command": "D:\\path\\to\\renpy-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "renpy_mcp.server"],
      "env": {
        "PYTHONPATH": "D:\\path\\to\\renpy-mcp\\src"
      }
    }
  }
}

Requirements

• Python 3.12+
• Ren’Py SDK 8.0+ (for compile_project and lint_project)
• MCP Python SDK

License

MIT — see LICENSE

---

中文

一个 MCP（模型上下文协议）服务器，让 AI Agent 能够操作 Ren’Py 视觉小说项目——读取脚本、注入代码、自动编译验证。

基于 FastMCP 构建。

为什么做这个？

Ren’Py 没有内置编辑器，开发者需要手动编写 .rpy 文本文件，然后点「启动项目」测试。这个 MCP 让任何 AI Agent 都可以成为 Ren’Py 的原生开发助手——你用自然语言描述需求，AI 生成正确的 Ren’Py 脚本、插入到正确位置、自动编译验证。

7 个工具

⚠️ AI Agent 使用前请先阅读 AI_GUIDE.md —— 包含完整工作流、常见坑和 9 大禁止事项。

快速开始

同上 English 部分。

演示流程

1. 用 list_labels 查看项目结构
2. 用 read_script 阅读现有脚本
3. 用 exec_rpy 注入新对话/角色/image/screen
4. 用 compile_project 验证语法
5. 在 Ren’Py Launcher 点「Launch Project」看效果

要求