Integrates with Google's Imagen API for generating visual representations of world elements based on textual descriptions.
Vibe Worldbuilding MCP
A Model Context Protocol (MCP) for creating detailed fictional worlds with Claude, complete with automatic image generation.
Overview
This MCP helps you build rich, cohesive fictional worlds through a structured approach to worldbuilding. It uses Claude's capabilities to help you develop concepts, explore details, and maintain consistency. The MCP can also generate images to visually represent your world's elements.
Installation
Install the MCP CLI:
pip install mcpInstall required dependencies:
pip install google-generativeaiInstall the Vibe Worldbuilding MCP with your Google AI API key:
cd /path/to/vibe-worldbuilding-mcp mcp install vibe_worldbuilding_server.py -v IMAGEN_API_KEY=your_api_key_hereThe
-v
flag sets the environment variable needed for image generation. If you don't have a Google AI API key for Imagen, you can still use the MCP for worldbuilding, but the image generation feature won't work.Alternatively, you can test the MCP in development mode:
mcp dev vibe_worldbuilding_server.py -v IMAGEN_API_KEY=your_api_key_here
How to Use
The MCP provides several prompts to guide your worldbuilding process:
start-worldbuilding - Begin a new world project
continue-worldbuilding - Resume work on an existing world
world-foundation - Develop the core concepts of your world
taxonomy - Create classification systems for world elements
world-entry - Create detailed entries for specific elements
consistency-review - Check for logical consistency
entry-revision - Revise and improve existing entries
workflow - Get guidance on the overall process
Image Generation
The MCP can generate images for your world elements. After creating a markdown file for an entry, taxonomy, or other element, use the generate_image_from_markdown_file
tool:
The tool will:
Read the content of your markdown file
Extract the title and description
Generate an appropriate image using Google's Imagen API
Save the image in an "images" folder next to your markdown file
You can then upload the generated image to Claude to view it in your conversation.
Worldbuilding Workflow
Start with the start-worldbuilding prompt to begin
For each new session, begin with continue-worldbuilding
Develop your world in this order:
World foundation (core concept and overview)
Taxonomies (classification systems)
Specific entries (detailed articles)
Let your world grow organically by developing elements that interest you
Generate images for your world elements to bring them to life visually
Example Session
Requirements
A Google AI API key for Imagen (set as the IMAGEN_API_KEY environment variable)
Google Generative AI Python library (
google-generativeai
)MCP CLI tool
Tips for Success
Build your world incrementally, starting with core concepts
Create clusters of related content
Review for consistency regularly
Focus on quality over quantity
Let your world emerge organically
Use generated images to inspire further worldbuilding
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol for creating detailed fictional worlds with Claude, featuring structured worldbuilding prompts and automatic image generation via Google's Imagen API.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that integrates Claude with Blender, enabling users to analyze and interact with IFC (Industry Foundation Classes) building models through natural language commands.Last updated -1124MIT License
Letz AI MCPofficial
AsecurityFlicenseAqualityA Model Context Protocol server that enables Claude to generate and upscale images through the Letz AI API, allowing users to create images directly within Claude conversations.Last updated -21- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact directly with Contentful CMS, allowing the AI to fetch content types and entries from a Contentful space.Last updated -2MIT License
- -securityAlicense-qualityA Model Context Protocol server that bridges Claude with ComfyUI, enabling AI image generation using Stable Diffusion through text prompts and custom workflows.