MCP Combined Server: 3D Cartoon Generator & File System Tools

基本能力

产品定位

MCP Combined Server: 3D Cartoon Generator & File System Tools 是一个专业级的服务器，提供高质量的3D风格卡通图像生成和安全的文件系统操作。

核心功能

1. 图像生成
2. 3D卡通生成：创建高质量的3D风格卡通图像
3. 儿童友好设计：专注于多彩、有趣和吸引人的视觉效果
4. 即时预览：自动在默认浏览器中打开生成的图像

5. 本地存储：将图像和预览保存在有组织的输出目录中

6. 文件系统操作

7. 安全文件访问：路径验证和安全检查
8. 读取/写入文件：读取和写入文本文件内容
9. 目录操作：列出、创建和导航目录

10. 文件搜索：查找匹配模式的文件

11. 系统特性

12. 专业配置：强大的错误处理和控制日志
13. 跨平台支持：智能文件路径处理，支持Windows、macOS和Linux
14. 智能操作系统检测：自动为每个操作系统找到最佳保存位置
15. 安全控制：通过配置限制目录访问

适用场景

• 需要高质量3D卡通图像生成的场景
• 需要安全文件系统操作的场景
• 跨平台文件管理和图像生成的应用

工具列表

1. Image Generation Tool

2. 功能：根据给定的提示生成3D风格的卡通图像

3. File System Tools

4. 功能：包括读取文件、写入文件、列出目录、创建目录和搜索文件等操作

常见问题解答

1. JSON Parsing Errors in Claude
2. 确保DEBUG设置为"false"以防止日志干扰JSON通信

3. 检查Claude配置中的JSON格式是否正确

4. File Access Denied

5. 验证尝试访问的路径是否包含在ALLOWED_DIRECTORIES中

6. 检查目标文件/目录的文件权限

7. Images Not Saving

8. 将SAVE_TO_DESKTOP设置为"true"以确保图像保存到桌面
9. 在服务器日志中检查桌面路径检测（临时启用DEBUG）

使用教程

使用依赖

• Node.js (v14或更高版本)
• Google Gemini API key
• TypeScript

安装教程

1. 克隆仓库：

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

1. 安装依赖：

npm install

1. 配置环境： 在根目录创建.env文件：

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

1. 构建项目：

npm run build

调试方式

1. 确保DEBUG设置为"false"以防止日志干扰JSON通信
2. 检查Claude配置中的JSON格式是否正确
3. 验证尝试访问的路径是否包含在ALLOWED_DIRECTORIES中
4. 检查目标文件/目录的文件权限
5. 将SAVE_TO_DESKTOP设置为"true"以确保图像保存到桌面
6. 在服务器日志中检查桌面路径检测（临时启用DEBUG）

许可证

该项目遵循 None 开源许可条款。