返回 MCP 目录
public公开dns本地运行

Vibe Worldbuilding

一个用于构建详细虚构世界的模型上下文协议,支持自动图像生成。

article

README

🚀 Vibe 世界构建 MCP

Vibe 世界构建 MCP 是一个模型上下文协议,可与克劳德协作,创建详细的虚构世界,还具备自动图像生成功能,能助力用户以结构化方式打造丰富连贯的虚构世界。

🚀 快速开始

该 MCP 借助结构化方法,帮助用户构建丰富、连贯的虚构世界。它利用克劳德的能力,辅助用户开发概念、探索细节并保持一致性,还能生成图像直观呈现世界元素。

📦 安装指南

  1. 安装 MCP CLI:

    pip install mcp
    
  2. 安装必要的依赖项:

    pip install google-generativeai
    
  3. 使用 Google AI API 密钥安装 Vibe 世界构建 MCP:

    cd /path/to/vibe-worldbuilding-mcp
    mcp install vibe_worldbuilding_server.py -v IMAGEN_API_KEY=your_api_key_here
    

    -v 标志用于设置图像生成的环境变量。若没有 Google AI API 密钥(Imagen),仍可使用 MCP 进行世界构建,但图像生成功能将无法使用。

    另外,可在开发模式下测试 MCP:

    mcp dev vibe_worldbuilding_server.py -v IMAGEN_API_KEY=your_api_key_here
    

💻 使用示例

基础用法

MCP 提供多个提示来指导世界构建过程:

  1. 开始新世界项目
  2. 继续现有世界的工作
  3. 开发世界的基石概念
  4. 创建世界元素的分类系统
  5. 为特定元素创建详细条目
  6. 检查逻辑一致性
  7. 修订和改进现有条目
  8. 获得整体流程指导

高级用法

MCP 可以为世界中的元素生成图像。在创建了条目、分类或其他元素的 Markdown 文件后,使用 generate_image_from_markdown_file 工具:

使用 generate_image_from_markdown_file 工具,路径为 "/path/to/your/file.md"

该工具将:

  1. 读取 Markdown 文件的内容
  2. 提取标题和描述
  3. 使用 Google 的 Imagen API 生成适当的图像
  4. 在 Markdown 文件旁边保存一个“images”文件夹中的图像

然后可上传生成的图像到克劳德以在对话中查看。

📚 详细文档

世界构建流程

  1. 首先使用 开始新世界 提示
  2. 每次新会话都从 继续现有世界 开始
  3. 按以下顺序开发世界:
    • 世界基石(核心概念和概述)
    • 分类系统(taxonomy)
    • 特定条目(详细文章)
  4. 让世界有机发展,通过探索感兴趣的元素来构建内容
  5. 为世界元素生成图像以使其生动起来

示例会话

用户:让我们创建一个新世界。

[用户从 MCP 菜单中选择“开始新世界”提示]

克劳德:[显示世界构建提示]

用户:我想创建一个声音具有魔法属性的世界。

克劳德:[帮助开发概念并探索影响]

用户:让我将此保存为我的世界概述文件。

克劳德:[将内容保存到 world-overview.md]

用户:现在为这个概述生成一张图像。

[用户使用 generate_image_from_markdown_file 工具]

克劳德:[生成图像并在磁盘上保存]

🔧 技术细节

要求

  • Google AI API 密钥(Imagen,设置为 IMAGEN_API_KEY 环境变量)
  • Google Generative AI Python 库 (google-generativeai)
  • MCP CLI 工具

成功技巧

  • 逐步构建世界,从核心概念开始
  • 创建相关内容的集群
  • 定期检查一致性
  • 注重质量而非数量
  • 让世界自然发展
  • 使用生成的图像来激发进一步的世界构建
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端