🎮 Ren'Py MCP 服务器
用AI构建视觉小说！ 一 模型上下文协议 一个服务器，允许AI助手创建包含图像、对话、分支故事和网页部署的完整Ren'Py视觉小说游戏。
](https://github.com/banjtheman/renpy_mcp_server)  
🎬 观看实际操作演示
🎥 演示视频
Watch Claude create a complete visual novel in minutes!
📸 示例输出
生成的背景（16:9）
具有多种情绪的角色精灵（2:3）
One character with 5 emotions (neutral, happy, sad, surprised, angry) - all generated in a single API call!
最终可玩游戏
Fully playable web games with branching dialogue and player choices
✨ 特点
- 🎨（美术/绘画相关表情，无具体文字含义，可理解为“美术”或“绘画”的象征） AI图像生成 - 使用Gemini 2.5 Flash Image制作背景（16:9）和角色（2:3）
- 🎭 表示戏剧或表演的符号。 情绪系统 每个角色在一次API调用中生成5种情绪（中性、快乐、悲伤、惊讶、愤怒）
- 📝 脚本生成 - AI编写完整的Ren'Py脚本，包含对话、选择和分支路径
- 🌐 代表“地球”或“全球网络”的符号。 网页构建 - 自动编译为可玩的网页游戏
- 🎬 表示电影或视频播放的符号 实时预览 - 本地HTTP服务器，用于即时测试游戏
- 魔杖（或类似魔杖的符号） 透明精灵（或：半透明图像精灵） - 自动移除角色精灵的背景
🚀 快速入门
自动化设置
# Clone and setup everything automatically
git clone https://github.com/banjtheman/renpy_mcp_server.git
cd renpy_mcp_server
./setup.sh
# Test your installation
./test_setup.sh
# (Optional) Test image generation directly
uv run python test_nano_banana.py这个（或“该”） setup.sh 脚本将会：
- ✅ 安装Python依赖项
- ✅ 下载并安装Ren'Py SDK（针对特定操作系统）
- ✅ 自动安装网页支持模块
- ✅ 帮助配置Gemini API密钥
- ✅ 创建MCP配置文件
- ✅ 测试所有功能是否正常
MCP 客户端配置
在您的MCP客户端配置（如Claude Desktop、Cursor等）中添加该服务器：
{
"mcpServers": {
"renpy_mcp_server": {
"command": "uv",
"args": [
"--directory",
"/FULL_PATH_TO_RENPY_MCP_SERVER",
"run",
"renpy-mcp-server"
],
"env": {
"GEMINI_API_KEY": "${GEMINI_API_KEY}",
"RENPY_SDK_PATH": "${RENPY_SDK_PATH}"
}
}
}
}替换：
/FULL_PATH_TO_RENPY_MCP_SERVER- 到此存储库的完整路径${GEMINI_API_KEY}- 您的Gemini API密钥${RENPY_SDK_PATH}- Ren'Py SDK 的路径（例如。，/path/to/renpy-8.4.1-sdk）
或者使用环境变量：
export GEMINI_API_KEY="your-api-key"
export RENPY_SDK_PATH="/path/to/renpy-8.4.1-sdk"手动设置
- 安装依赖项
uv sync- 设置Ren'Py SDK
- 在安装过程中，SDK和Web模块会自动下载 - 无需手动启动器交互
- 获取Gemini API密钥
- 访问 Google AI Studio（谷歌人工智能工作室） - 创建API密钥
- 配置环境
export RENPY_SDK_PATH="/path/to/renpy-sdk"
export GEMINI_API_KEY="your-api-key"- 添加到MCP客户端
- 参见上文的“MCP 客户端配置”部分 - 当您的MCP客户端连接时，服务器将自动启动
🎮 使用方法
基本工作流程
- 创建一个项目
create_project(name="my_vn")- 生成资产
generate_background(project_name="my_vn", description="Cozy café interior, evening time...")
generate_character(project_name="my_vn", character_name="alice", description="Friendly barista...", generate_emotions=True)- 写这个故事
generate_script(project_name="my_vn", script_name="intro", script_content="label intro:\n scene bg cafe\n show alice happy\n Alice \"Welcome!\"\n return")- 检查并编辑 （可选）
list_project_files(project_name="my_vn") # See all files
read_project_file(project_name="my_vn", file_path="intro.rpy") # Read a script
edit_project_file(project_name="my_vn", file_path="intro.rpy", content="...") # Update it- 构建并预览
build_project(project_name="my_vn")
start_web_preview(project_name="my_vn")📚 文档
- 示例 - Claude Agent SDK 与 Strands 集成示例
🤝 贡献
我们欢迎投稿！请参见 \CONTRIBUTING.md\ 翻译为中文是：“贡献指南文件（Markdown 格式）” 作为指南。
📄 许可证
MIT 许可证 - 请参阅 许可证 详情如下。
______________________________________________________________________
祝你创作视觉小说愉快！ 🎮✨（游戏控制台表情加闪耀星星表情）