AI导哈

AI叙事引擎

Puch Adventure Engine是一款基于AI技术的叙事游戏引擎，允许用户进入任何虚构宇宙，扮演任何角色，探索无限‘假设’场景，创造独特的分支叙事。

  • by cr7ritesh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 cr7ritesh/adventure_engine

使用说明

Puch探险引擎

重写你最喜欢的故事

你有没有希望改变你最喜欢的电影的结局？
或者探索如果一个关键人物做出不同的选择会发生什么？
Puch探险引擎 是一款有状态、人工智能驱动的讲故事游戏，让你坐在导演的椅子上。

作为a建造 模型上下文协议（MCP）服务器 对于Puch AI客户端，这个引擎可以让你进入任何虚构的世界，成为任何角色，探索无限的“假设”场景。带领史塔克家族在《权力的游戏》中取得胜利，看看如果沃尔特·怀特在《绝命毒师》中拒绝做饭，或者在自己创造的世界中创造全新的冒险，会发生什么。在谷歌的Gemini API的支持下，你所做的每一个选择都会产生一个独特的分支叙事。

🚀 主要特点

  • 无限的故事可能性
    该引擎由Google Gemini API提供动力，充当一个动态的地牢大师，为每一个选择创造独特的叙事、角色和结果。

  • 探索“如果”
    深入了解你最喜欢的电视节目、电影和书籍。改变角色的命运，看看故事是如何根据你的决定展开的。

  • 真正的球员经纪公司
    不喜欢提供的选项？键入您自己的自定义操作，以引导故事向任何方向发展。

  • 国事和私人会议
    为每个用户提供持久、独特的游戏状态。随时离开并返回您的冒险之旅。

  • 视觉体验丰富
    每一个叙事转折都伴随着一个场景图像。（演示使用占位符图像；引擎支持AI生成的图像。）

  • 无缝Puch AI集成
    内置于Puch AI聊天客户端中。

🛠️ 入门指南：5分钟设置指南

先决条件

  • python 3.9+
  • uv （快速Python包安装程序）
  • 活跃的 ngrok 账户

步骤1：克隆存储库

git clone <your-repo-url>
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://<random-string>.ngrok-free.app).

🎮 如何玩

  • 连接您的服务器：
    使用 /mcp connect 使用您的ngrok URL和密码的命令 AUTH_TOKEN.
    不添加 /mcp 到URL的末尾。

    /mcp connect https://<your-ngrok-url>.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)
  • 服务器： 乌维科恩

准备好重写你最喜欢的故事了吗？现在就开始你的冒险吧！

相关 MCP