3D Cartoon Generator & File System MCP Server
Generates high-quality 3D-style cartoon images based on text prompts using Google Gemini AI, featuring instant browser previews and local storage.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@3D Cartoon Generator & File System MCP Server Generate a 3D cartoon of a friendly dragon and save it as dragon_art"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Combined Server: 3D Cartoon Generator & File System Tools
A professional-grade server that provides two major capabilities:
High-quality 3D-style cartoon image generation using Google's Gemini AI
Secure file system operations for reading, writing, and managing files

π Features
Image Generation
3D Cartoon Generation: Creates high-quality 3D-style cartoon images
Child-Friendly Design: Focuses on colorful, playful, and engaging visuals
Instant Preview: Automatically opens generated images in your default browser
Local Storage: Saves images and previews in an organized output directory
File System Operations
Secure File Access: Path validation and security checks
Read/Write Files: Read and write text file contents
Directory Operations: List, create, and navigate directories
File Search: Find files matching patterns
System Features
Professional Configuration: Robust error handling and controlled logging
Cross-Platform Support: Intelligent file path handling for Windows, macOS, and Linux
Smart OS Detection: Automatically finds the best save location for each operating system
Security Controls: Restricted directory access through configuration
Related MCP server: MCP Filesystem Server
π οΈ Technical Stack
Core Framework: Model Context Protocol (MCP) SDK
AI Integration: Google Generative AI (Gemini)
Runtime: Node.js v14+
Language: TypeScript
Package Manager: npm
π Prerequisites
Node.js (v14 or higher)
Google Gemini API key
TypeScript
βοΈ Installation
Clone the repository:
git clone https://github.com/falahgs/mcp-3d-style-cartoon-gen-server.git
cd mcp-3d-style-cartoon-gen-serverInstall dependencies:
npm installConfigure environment: Create a
.envfile in the root directory:
GEMINI_API_KEY=your_api_key_here
ALLOWED_DIRECTORIES=/path/to/allowed/dir1,/path/to/allowed/dir2Build the project:
npm run buildπ§ Configuring Claude Desktop with MCP Server
To integrate this combined server with Claude Desktop:
Locate the Configuration File:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Add the following configuration:
{
"mcpServers": {
"mcp-3d-cartoon-generator": {
"command": "node",
"args": [
"path/to/your/build/index.js"
],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key_here",
"IS_REMOTE": "true",
"SAVE_TO_DESKTOP": "true",
"DETECT_OS_PATHS": "true",
"ALLOWED_DIRECTORIES": "C:\\Users\\YourUsername\\Desktop,C:\\Users\\YourUsername\\Documents",
"DEBUG": "false"
}
}
}
}Windows PowerShell Helper Script
For Windows users, you can use the included fix_claude_config.ps1 script to automatically configure Claude Desktop:
Edit the script to update the path to your server build and your Gemini API key
Run the script in PowerShell:
powershell -ExecutionPolicy Bypass -File .\fix_claude_config.ps1This will create or update the configuration file with proper encoding and settings.
π Available Tools
1. Image Generation Tool
{
"name": "generate_3d_cartoon",
"description": "Generates a 3D style cartoon image for kids based on the given prompt",
"inputSchema": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "The prompt describing the 3D cartoon image to generate"
},
"fileName": {
"type": "string",
"description": "The name of the output file (without extension)"
}
},
"required": ["prompt", "fileName"]
}
}2. File System Tools
Read File
{
"name": "read_file",
"description": "Read the contents of a file",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Path to the file to read"
}
},
"required": ["path"]
}
}Write File
{
"name": "write_file",
"description": "Write content to a file",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Path to the file to write"
},
"content": {
"type": "string",
"description": "Content to write to the file"
}
},
"required": ["path", "content"]
}
}List Directory
{
"name": "list_directory",
"description": "List the contents of a directory",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Path to the directory to list"
}
},
"required": ["path"]
}
}Create Directory
{
"name": "create_directory",
"description": "Create a new directory",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Path to the directory to create"
}
},
"required": ["path"]
}
}Search Files
{
"name": "search_files",
"description": "Search for files matching a pattern",
"inputSchema": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Base directory to search from"
},
"pattern": {
"type": "string",
"description": "Search pattern (glob format)"
},
"excludePatterns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Patterns to exclude from search (glob format)"
}
},
"required": ["path", "pattern"]
}
}π Example Usage
Image Generation Examples
// Generate a 3D cartoon
{
"name": "generate_3d_cartoon",
"arguments": {
"prompt": "A friendly robot playing with a cat",
"fileName": "robot_cat_play"
}
}File System Examples
// Read a file
{
"name": "read_file",
"arguments": {
"path": "C:/Users/YourUsername/Documents/example.txt"
}
}
// Write a file
{
"name": "write_file",
"arguments": {
"path": "C:/Users/YourUsername/Documents/new-file.txt",
"content": "This is the content of the file."
}
}
// List directory contents
{
"name": "list_directory",
"arguments": {
"path": "C:/Users/YourUsername/Documents"
}
}
// Create a directory
{
"name": "create_directory",
"arguments": {
"path": "C:/Users/YourUsername/Documents/new-folder"
}
}
// Search for files
{
"name": "search_files",
"arguments": {
"path": "C:/Users/YourUsername/Documents",
"pattern": "*.txt",
"excludePatterns": ["temp*", "*.tmp"]
}
}π Security Features
The server implements several security measures:
Path Validation: All file paths are validated to ensure they are within allowed directories.
Allowed Directories: Only directories explicitly set in the
ALLOWED_DIRECTORIESenvironment variable can be accessed.Symlink Protection: Prevents access to directories outside the allowed scope via symlinks.
Controlled Logging: Debug logs are disabled by default to prevent information leakage.
βοΈ Configuration Options
Environment Variables
Variable | Description | Default |
| Google Gemini API key for image generation | (Required) |
| Comma-separated list of allowed file system paths | User's home dir, current dir |
| Run in remote mode without browser opening | false |
| Force saving to desktop directory | false |
| Enable OS-specific path detection | true |
| Enable verbose debug logging | false |
π οΈ Troubleshooting
Common Issues:
JSON Parsing Errors in Claude:
Ensure
DEBUGis set to "false" to prevent logs from interfering with JSON communicationCheck for proper JSON formatting in the Claude configuration
File Access Denied:
Verify that the paths you're trying to access are included in
ALLOWED_DIRECTORIESCheck file permissions on the target files/directories
Images Not Saving:
Set
SAVE_TO_DESKTOPto "true" to ensure images save to the desktopCheck desktop path detection in the server logs (enable DEBUG temporarily)
π License
π€ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Available Tools
6 toolscreate_directoryB
Create a new directory
Inputs: path (required).
generate_3d_cartoonB
Generates a 3D style cartoon image for kids based on the given prompt
Inputs: prompt (required), fileName (required).
list_directoryC
List the contents of a directory
Inputs: path (required).
read_fileB
Read the contents of a file
Inputs: path (required).
search_filesC
Search for files matching a pattern
Inputs: path (required), pattern (required), excludePatterns.
write_fileB
Write content to a file
Inputs: path (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
The tools clearly separate file system operations (create, list, read, search, write) from the image generation task. No two tools have overlapping purposes.
All tools follow a consistent verb_noun pattern (e.g., create_directory, generate_3d_cartoon), making it easy to predict functionality from names.
Six tools is well-scoped for a server combining file system management and a single generative feature. Each tool serves a distinct need without unnecessary bloat.
The file system side lacks basic operations like delete_file or move_file, and the relationship between file storage and cartoon generation is unclear (e.g., no tool to save generated images). Minor gaps reduce effectiveness.
Maintenance
Related MCP Connectors
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate your app's mascot, then props, poses and animations that stay on-model.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Generate images, video, speech, 3D, slide decks, Word/Excel/PDF docs, product cards, and AI chat.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables AI models to perform file system operations (reading, creating, and listing files) on a local file system through a standardized Model Context Protocol interface.3ISC
- AlicenseAqualityDmaintenanceProvides secure filesystem access for AI models through the Model Context Protocol with strict path validation, file operations, directory management, and system command execution within predefined directories.1681 npmMIT
- AlicenseBqualityDmaintenanceEnables image generation using Google Gemini models like Gemini 2.0 Flash and Imagen 3.0 with support for custom aspect ratios and negative prompts. It also allows users to list and manage generated images stored in local directories.232 npmMIT
- FlicenseBqualityDmaintenanceProvides tools for file system operations and text generation using OpenAI-compatible models via the Model Context Protocol, supporting both stdio and HTTP transports.6-