3D Cartoon Generator & File System Tools

Generates 3D-style cartoon images using Google's Gemini AI and provides secure file system operations.

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

- 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

- 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

- 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

- Core Framework: Model Context Protocol (MCP) SDK
- AI Integration: Google Generative AI (Gemini)
- Runtime: Node.js v14+
- Language: TypeScript
- Package Manager: npm

- Node.js (v14 or higher)
- Google Gemini API key
- TypeScript

git clone https://github.com/falahgs/mcp-3d-style-cartoon-gen-server.git cd mcp-3d-style-cartoon-gen-server

- Configure environment: Create a.envfile in the root directory:

GEMINI_API_KEY=your_api_key_here ALLOWED_DIRECTORIES=/path/to/allowed/dir1,/path/to/allowed/dir2

🔧 Configuring Claude Desktop with MCP Server

To integrate this combined server with Claude Desktop:

- Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json

{ "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" } } } }

For Windows users, you can use the includedfix_claude_config.ps1script 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.ps1

This will create or update the configuration file with proper encoding and settings.

{ "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"] } }

{ "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"] } }

{ "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"] } }

{ "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"] } }

{ "name": "create_directory", "description": "Create a new directory", "inputSchema": { "type": "object", "properties": { "path": { "type": "string", "description": "Path to the directory to create" } }, "required": ["path"] } }

{ "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"] } }

// Generate a 3D cartoon { "name": "generate_3d_cartoon", "arguments": { "prompt": "A friendly robot playing with a cat", "fileName": "robot_cat_play" } }

// 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"] } }

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 theALLOWED_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.

- EnsureDEBUGis set to "false" to prevent logs from interfering with JSON communication
- Check for proper JSON formatting in the Claude configuration

- Verify that the paths you're trying to access are included inALLOWED_DIRECTORIES
- Check file permissions on the target files/directories

- SetSAVE_TO_DESKTOPto "true" to ensure images save to the desktop
- Check desktop path detection in the server logs (enable DEBUG temporarily)

Contributions are welcome! Please feel free to submit a Pull Request.

Pre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, and Hermes Agent — fewer tokens, fewer tool calls, 100% local

Inspect hidden Unicode for free. Rewrite published statistical text watermarks (Claude, Gemini) or strip C2PA/file metadata. Same credits as the API.

Bridge to Google Gemini API. Access Gemini Pro and Flash models through MCP.

A Text-to-Speech server supporting multiple backends like macOS say, ElevenLabs, Google Gemini, and OpenAI TTS.

Secure audio transcription meets AI. Connect Alice recordings to Claude, ChatGPT, Gemini, and more.

Growth marketing, SEO and GEO as agent tools: 41 tools for ranked growth moves, drafted deliverables, ship actions, and AI answer visibility across ChatGPT, Gemini, Perplexity and Google AI Overviews, hosted remote at https://afterlaunch.io/api/mcp with anonymous discovery and OAuth.

Access GPT-5, Claude, Gemini and other models through a single MCP connection. Save development time and money on subscriptions.

Universal tool adapter — @tool decorator exports Python functions to OpenAI, Claude, Gemini, MCP, JSON Schema. Audit token costs.

Standing review layer for coding agents: Claude, GPT and Gemini debate each answer and return one recommendation plus the strongest dissent.

Integrates with Google AI Studio/Gemini API for PDF to Markdown conversion and content generation.