mcp-3d-style-cartoon-gen

MCP server from falahgs/mcp-3d-style-cartoon-gen-server

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio falahgs-mcp-3d-style-cartoon-gen-server node path/to/your/build/index.js \
  --env DEBUG="false" \
  --env IS_REMOTE="true" \
  --env GEMINI_API_KEY="your_gemini_api_key_here" \
  --env DETECT_OS_PATHS="true" \
  --env SAVE_TO_DESKTOP="true" \
  --env ALLOWED_DIRECTORIES="/path/to/allowed/dir1,/path/to/allowed/dir2"

How to use

This MCP server combines two core capabilities: a 3D-style cartoon image generator powered by Google Gemini and a secure file system toolset for reading, writing, listing, and searching files. The image generation tool accepts a prompt and an output file name to create kid-friendly 3D-style visuals, with an instant preview option and local storage for generated images. The file system tools provide read, write, list, create, and search operations with path validation and restricted access to configured allowed directories, ensuring safe and controlled file management across platforms. To use the tools, connect to the MCP server via your client (e.g., Claude Desktop integration or your own MCP client) and invoke the available commands such as generate_3d_cartoon, read_file, write_file, list_directory, create_directory, and search_files. When generating images, you supply a prompt and a target file name; for file operations, you provide the required path and content (for write) or query patterns (for search). The server handles security checks, cross-platform path handling, and OS-aware save paths automatically.

How to install

Prerequisites:

Node.js (v14 or higher) installed on your system
npm installed
A Google Gemini API key
TypeScript tooling (if building from source)

Installation steps:

Clone the repository: git clone https://github.com/falahgs/mcp-3d-style-cartoon-gen-server.git cd mcp-3d-style-cartoon-gen-server
Install dependencies: npm install
Configure environment variables: Create a .env file in the root with at least: GEMINI_API_KEY=your_api_key_here ALLOWED_DIRECTORIES=/path/to/allowed/dir1,/path/to/allowed/dir2
Build the project (if applicable): npm run build
Run the server (example): npm start

Note: The MCP config (e.g., Claude Desktop integration) may require embedding the server command and environment details into your platform's configuration as shown in the documentation.

Additional notes

Tips and considerations:

Ensure ALLOWED_DIRECTORIES covers only the directories you intend to expose; symlink protection helps prevent escape from the allowed scope.
Keep GEMINI_API_KEY secure and do not commit it to version control.
Set DETECT_OS_PATHS to true to enable OS-aware save locations for generated images.
If you encounter verbose logs, toggle DEBUG to false in your environment to minimize output in production.
The secure file system tools rely on strict path validation; always provide correct paths and verify permissions to avoid access issues.
For cross-platform usage, ensure the server has access to the same paths across Windows, macOS, and Linux where applicable.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.