generate_3d_cartoonLABSCO SUMMARY
Cartoon generation and a file sandbox in one install.
The image half produces child-friendly 3D-style artwork and puts it on disk; the file half gives the assistant read and write access inside directories you nominate. They are two jobs sharing one server, so it earns its slot when you want both.
What it is
One server carrying two separate capabilities: 3D-style cartoon image generation through Google's Gemini model, and sandboxed file system operations. Generated images are saved to an output directory and opened in the default browser; file access is confined to the directories named in ALLOWED_DIRECTORIES.
What you get
- 3D-style cartoon images, aimed at colourful child-friendly output
- Each image saved locally and opened in the browser for an immediate look
- Text files read and written
- Directories listed, created and navigated
- Files found by pattern
- Access restricted to the directories you list, with path validation and security checks
- Path handling for Windows, macOS and Linux, with the save location picked per platform
Requirements
Node.js v14 or higher, TypeScript, and a Google Gemini API key. GEMINI_API_KEY and ALLOWED_DIRECTORIES go in a .env file at the project root; the repository is cloned and built with npm run build.
Setup effort
Build from source — clone the repository, then follow the project's own run instructions
USE CASES
01
Making illustrations for a children's story
Describe the scene, get a 3D-style cartoon back, and have it saved to the output directory and opened in the browser.
02
Letting it touch files without opening the disk
List the directories it may reach in ALLOWED_DIRECTORIES; anything outside them is refused and paths are validated against traversal.
03
Finding the file you meant
Search the allowed directories by pattern, then read the match, in the same exchange.
04
Writing output where you will use it
Generated text and images both land in directories you chose, rather than a temporary location you have to go hunting through.
6 tools
Listed in project docs. Your client may show a different list.
read_filewrite_filelist_directorycreate_directorysearch_filesBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- node on PATH
- Node.js
- GEMINI_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/falahgs/mcp-3d-style-cartoon-gen-server.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-3d-cartoon-generator": {
"command": "node",
"args": [
"<YOUR_PATH_TO_BUILD>/index.js"
],
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"IS_REMOTE": "true",
"SAVE_TO_DESKTOP": "true",
"DETECT_OS_PATHS": "true",
"ALLOWED_DIRECTORIES": "C:\\Users\\<YOUR_USERNAME>\\Desktop,C:\\Users\\<YOUR_USERNAME>\\Documents",
"DEBUG": "false"
}
}
}
}Claude Desktop — PowerShell helper
CLAUDE DESKTOP — POWERSHELL HELPER · TERMINAL
powershell -ExecutionPolicy Bypass -File .\fix_claude_config.ps1
