Puch探险引擎
*重写你最喜欢的故事*
______________________________________________________________________
你有没有希望改变你最喜欢的电影的结局？\ 或者探索如果一个关键人物做出不同的选择会发生什么？\ Puch探险引擎 是一款有状态、人工智能驱动的讲故事游戏，让你坐在导演的椅子上。
作为a建造 模型上下文协议（MCP）服务器 对于Puch AI客户端，这个引擎可以让你进入任何虚构的世界，成为任何角色，探索无限的“假设”场景。带领史塔克家族在《权力的游戏》中取得胜利，看看如果沃尔特·怀特在《绝命毒师》中拒绝做饭，或者在自己创造的世界中创造全新的冒险，会发生什么。在谷歌的Gemini API的支持下，你所做的每一个选择都会产生一个独特的分支叙事。
______________________________________________________________________
🚀 主要特点
- 无限的故事可能性\
该引擎由Google Gemini API提供动力，充当一个动态的地牢大师，为每一个选择创造独特的叙事、角色和结果。
- 探索“如果”\
深入了解你最喜欢的电视节目、电影和书籍。改变角色的命运，看看故事是如何根据你的决定展开的。
- 真正的球员经纪公司\
不喜欢提供的选项？键入您自己的自定义操作，以引导故事向任何方向发展。
- 国事和私人会议\
为每个用户提供持久、独特的游戏状态。随时离开并返回您的冒险之旅。
- 视觉体验丰富\
每一个叙事转折都伴随着一个场景图像。（演示使用占位符图像；引擎支持AI生成的图像。）
- 无缝Puch AI集成\
内置于Puch AI聊天客户端中。
______________________________________________________________________
🛠️ 入门指南：5分钟设置指南
先决条件
______________________________________________________________________
步骤1：克隆存储库
git clone
cd puch-adventure-engine______________________________________________________________________
第二步：设置环境
# Create the virtual environment
uv venv
# Activate the environment (macOS/Linux)
source .venv/bin/activate
# Install all required packages
uv pip install -r requirements.txt______________________________________________________________________
步骤3：配置密钥
创建一个 .env 根目录中的文件。您可以复制 .env.example 如果提供。
# This is a password YOU invent. It will be used to connect to your server.
AUTH_TOKEN="a-secret-password-of-your-choice"
# Your phone number in the format required by Puch AI for validation.
MY_NUMBER="919876543210"
# Your free API key from Google AI Studio for the Gemini model.
GEMINI_API_KEY="your_google_gemini_api_key_here"______________________________________________________________________
步骤4：运行服务器
python adventure_engine.py您应该看到： 🚀 Starting MCP server...______________________________________________________________________
步骤5：使用ngrok暴露您的服务器
打开一个新的终端窗口：
ngrok http 8086复制ngrok提供的HTTPS“转发”URL（例如。， https://.ngrok-free.app).
______________________________________________________________________
🎮 如何玩
- 连接您的服务器：\
使用 /mcp connect 使用您的ngrok URL和密码的命令 AUTH_TOKEN.\ *不添加 /mcp 到URL的末尾。*
/mcp connect https://.ngrok-free.app your-secret-token- 开始你的冒险：\
最可靠的开始方式是明确地调用 start_adventure 工具。
@PuchAdventureEngine start_adventure- 做出选择：\
AI地牢大师将呈现场景、图像和选择。键入建议的选项或您自己的自定义操作。
- 管理您的游戏：
- @PuchAdventureEngine show_status --检查角色的库存。 - @PuchAdventureEngine reset_adventure --结束当前的游戏，重新开始。
______________________________________________________________________
🧑💻 技术栈
- 后端： python
- MCP框架： FastMCP
- 文本生成： Google Gemini API(
gemini-1.5-flash) - 图像生成： 占位符服务(via.placeholder.com)
- 服务器： 乌维科恩
______________________________________________________________________
准备好重写你最喜欢的故事了吗？现在就开始你的冒险吧！