🎓 MCP-Course-Maker

基于 MCP 协议的线性课程开发与内容制作平台。本项目集成了 AI 生成、3D建模、TTS、Excel/Word 自动化、Unity 编辑器自动化等多种能力，所有服务均以 MCP Server 形式统一管理，适配 Cursor、Claude Desktop 等主流 AI IDE。

🌍 一、全局基础环境准备

🐍 1. Python

推荐版本：Python 3.10 及以上（部分包如 image-gen-server 要求 3.10+，tripo-mcp/instant-meshes-mcp 推荐 3.8+）
安装方式：

访问 python.org 下载并安装，务必勾选"Add Python to PATH"。

🟢 2. Node.js & npm

推荐版本：Node.js 18 及以上（部分服务如 excel-mcp-server 需 20+，建议统一 20+）
安装方式：

访问下载并安装。

⚡ 3. uv 包管理器

安装命令（Windows）：

  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

添加到 PATH（如未自动添加）：

  set Path=%USERPROFILE%\.local\bin;%Path%

🔧 4. 其他依赖

pip：Python 包管理工具，随 Python 安装。
npx：随 Node.js 安装。
Unity：如需使用 unityMCP，建议 Unity 2020.3 LTS 及以上，推荐 unity6000 版本，且项目路径无空格。

🖥️ 二、各子包详细环境配置步骤

🎮 1. unitymcp（Unity 编辑器自动化）

参考：Unity MCP 文档

🎯 安装 Unity

- 推荐 Unity 2020.3 LTS 及以上，建议 unity6000 版本。 - 项目路径和 MCP-Course-Maker 目录下的所有子目录不要有空格。

🐍 安装 Python 3.12+ 和 uv

- 见全局基础环境准备。

📦 Unity 项目中安装 Unity MCP 包

- 打开 Unity → Window → Package Manager → Add package from git URL 填写：https://github.com/VR-Jobs/UnityMCPbeta.git

📦 安装 Python 依赖

- 进入 Assets/unitymcp/Python 目录，激活虚拟环境并安装 requests：

     cd Assets/unitymcp/Python
     .venv\Scripts\activate  # Windows
     # 或 source .venv/bin/activate  # macOS/Linux
     uv pip install requests

⚙️ 配置 MCP Server

- 在 MCP 客户端（如 Cursor/Claude）设置中添加如下配置：

     {
       "mcpServers": {
         "unityMCP": {
           "command": "uv",
           "args": [
             "--directory",
             "你的绝对路径/MCP-Course-Maker/unitymcp/Python",
             "run",
             "server.py"
           ]
         }
       }
     }

🚀 启动服务

- 启动 Unity 编辑器，确保 MCP 窗口处于活动状态。 - MCP 客户端会自动调用上述命令启动服务。

📊 2. excel-mcp-server（Excel 读写）

参考：Assets/excel-mcp-server/README.md

✨ 功能简介

- 📊 创建和修改 Excel 工作簿 - 📝 读写数据 - 🎨 应用格式和样式 - 📈 创建图表和可视化 - 📊 生成数据透视表 - 🔄 管理工作表和范围 - 无需本地安装 Microsoft Excel，AI 可直接操作 Excel 文件

📦 安装方式

- 进入 Assets/excel-mcp-server 目录，执行：

     uv venv
     uv pip install -e .

🚀 启动服务

- 默认端口 8000：

     uv run excel-mcp-server

- 自定义端口（如 8080）：

     # Bash/Linux/macOS
     export FASTMCP_PORT=8080 && uv run excel-mcp-server
     # Windows PowerShell
     $env:FASTMCP_PORT = "8080"; uv run excel-mcp-server

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "excel": {
           "url": "http://localhost:8000/sse",
           "env": {
             "EXCEL_FILES_PATH": "/path/to/excel/files"
           }
         }
       }
     }

- 说明： - url：excel-mcp-server 服务的 SSE 地址，通常为 http://localhost:8000/sse - EXCEL_FILES_PATH：Excel 文件的根目录，所有读写操作均以此为根目录

🌐 协议与远程部署

- 本服务使用 Server-Sent Events (SSE) 协议。 - 如需与仅支持 stdio 的客户端（如 Claude Desktop）对接，可用 Supergateway 进行协议转换。 - 远程部署/云端托管请参考 Remote MCP Server Guide

🛠️ 工具文档

- 完整工具列表与用法详见 TOOLS.md

📁 3. file-simp-server（文件自动重命名和压缩解压工具 FileSimp MCP Server）

参考：下述说明

✨ 功能说明

- 支持对本地音频、图片、3D模型等文件进行自动重命名。 - 可按关键词、用户指定名或当前时间自动命名，遇重名自动递增序号，确保唯一。 - 支持类型：音频（mp3/wav）、图片（jpg/png/jpeg）、3D模型（glb/obj/fbx/stl/3mf）。 - 支持解压zip文件到指定目录，包括密码保护的zip文件。 - 适用于所有AI生成内容的自动归档与规范化管理，以及文件解压需求。 - 支持项目下相对路径到绝对路径的转换需求。

🔧 安装与依赖

- Python 3.8+，已安装 fastmcp。 - 进入 file-simp-server 目录，执行：

     pip install -e .

⚙️ 配置 MCP Server

- 在 MCP 客户端（如 Cursor）配置 mcp.json，添加如下内容：

     "FileSimp": {
       "command": "file-simp-server",
      "env": {
        "PROJECT_ROOT": "你的绝对路径（项目根目录）"
      }
     }

🛠️ 工具注册与调用示例

📝 文件重命名工具（rename_files）： - 参数： - folder：目标文件夹路径 - file_type：文件类型（audio/image/model/all） - files：需要重命名的文件名列表（必填） - new_name：直接命名（如"光度计.jpg"，可选） - keyword：关键词命名（如"光度计"，可选） - ext：指定后缀（如".mp3"，可选）

📦 zip文件解压工具（extract_zip）： - 参数： - zip_path：zip文件的完整路径（必填） - extract_to：解压到的目标目录（可选，默认为zip文件同级目录的子文件夹） - password：zip文件密码（可选） - 功能特性： - 自动创建解压目录 - 支持密码保护的zip文件 - 完善的错误处理（文件不存在、格式错误、密码错误等） - 返回详细的解压结果和文件列表

🗣️ 4. doubaomcp（豆包TTS，火山引擎 TTS）

参考：豆包TTS文档

🐍 安装 Python 3.8+ 和依赖

- 进入 doubao-tts-mcp 目录，执行：

     pip install -e .

🔑 配置环境变量

- 可在 .env 或 MCP 配置的 env 字段中设置：

     VOLC_APPID=请替换为你的AppID
     VOLC_TOKEN=请替换为你的Token
     PORT=5001
     OUTPUT_DIR=你的绝对路径/MCP-Course-Maker/doubaomcp/doubaoOutput

- AppID 和 Token 获取方法见下图： ![](./环境配置图示/豆包.png)

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "DoubaoTTS": {
           "command": "doubao-tts-mcp",
           "args": [],
           "env": {
             "VOLC_APPID": "请替换为你的AppID",
             "VOLC_TOKEN": "请替换为你的Token",
             "PORT": "5001",
             "OUTPUT_DIR": "你的目标输出路径"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🎤 5. elevenlabs-mcp（ElevenLabs TTS）

参考：elevenlabs-mcp 官方文档

🐍 安装 Python 3.12+ 和依赖

- 进入 elevenlabs-mcp 目录，执行：

     pip install -e .

🔑 配置 API Key 和输出目录

- 在 MCP 配置的 env 字段中设置：

     ELEVENLABS_API_KEY=请替换为你的ElevenLabs API Key
     ELEVENLABS_MCP_BASE_PATH=你的绝对路径/MCP-Course-Maker/elevenlabs-mcp/elevenlabsOutput

- API Key 获取方法见下图： ![](./环境配置图示/elevenlabs.png)

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "ElevenLabs": {
           "command": "elevenlabs-mcp-server",
           "env": {
             "ELEVENLABS_API_KEY": "请替换为你的ElevenLabs API Key",
             "ELEVENLABS_MCP_BASE_PATH": "你的目标输出路径"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🤖 6. MiniMax（AI 生成/对话/多模态）

参考：MiniMax-MCP 官方文档

🔑 获取 API Key

- 前往 MiniMax Global 或 MiniMax中国区获取你的 API Key。

⚡ 安装 uvx

- uvx 随 uv 安装，若未安装请参考 uv 官方文档。

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "MiniMax": {
           "command": "uvx",
           "args": [
             "minimax-mcp"
           ],
           "env": {
             "MINIMAX_API_KEY": "请替换为你的MiniMax API Key",
             "MINIMAX_MCP_BASE_PATH": "你的输出目录",
             "MINIMAX_API_HOST": "https://api.minimax.chat 或 https://api.minimaxi.chat",
             "MINIMAX_API_RESOURCE_MODE": "local 或 url"
           }
         }
       }
     }

- ⚠️ 注意：API Key 和 Host 必须区域匹配，否则会报 invalid api key 错误。 - 全球区 Host：https://api.minimaxi.chat - 中国区 Host：https://api.minimax.chat

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🎨 7. image-gen-server-main（即梦AI图像生成）

参考：image-gen-server 文档

🐍 安装 Python 3.10+ 和 uv

- 见全局基础环境准备。

📦 安装依赖

- 进入 image-gen-server-main 目录，执行：

     pip install -e .

🔑 配置 API Token 和图片保存路径

- 推荐在 mcp.json 的 JiMengAI 服务下配置 env 字段：

       "JIMENG_API_TOKEN": "请替换为你的即梦sessionid",
       "IMG_SAVA_FOLDER": "请替换为你的图片保存目录"

- server.py 已支持自动读取上述环境变量，无需再在代码或 .env 文件中硬编码。 - sessionid 获取方法：登录即梦官网，F12 → Application → Cookies → 找到 sessionid。

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "JiMengAI": {
           "command": "image-gen-server",
           "env": {
             "JIMENG_API_TOKEN": "请替换为你的即梦sessionid",
             "IMG_SAVA_FOLDER": "请替换为你的图片保存目录"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🖼️ 8. baidu-image-recognition-mcp（百度图像识别 MCP 工具）

参考：baidu-image-recognition-mcp/README.md

🐍 安装 Python 3.8+ 和依赖

- 进入 baidu-image-recognition-mcp 目录，执行：

     pip install -e .

🔑 配置 API Key

- 编辑 .env 文件，添加：

     BAIDU_API_KEY=your_actual_api_key
     BAIDU_SECRET_KEY=your_actual_secret_key

- API Key 获取方法： 1. 注册百度智能云账号： 2. 控制台 → 人工智能 → 图像识别 → 创建应用，获取API Key和Secret Key

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "BaiduImageRecognition": {
           "command": "baidu-mcp-server",
           "env": {
             "BAIDU_API_KEY": "your_actual_api_key",
             "BAIDU_SECRET_KEY": "your_actual_secret_key"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🖼️ 9. picui-image-upload-mcp（Picui 图床 MCP Server）

参考：picui-image-upload-mcp/README.md

✨ 功能简介

- 基于 PICUI 图床的多功能 API 封装，支持用户资料、策略列表、Token 生成、图片上传（本地文件）、图片列表、删除图片、相册列表、删除相册等操作，适用于 MCP 智能体工具集成。

🔧 依赖环境

- Python 3.8+ - 依赖包见 picui-image-upload-mcp/requirements.txt

🚀 快速开始

- 进入 picui-image-upload-mcp 目录，执行：

    pip install -e .

⚙️ mcpjson 配置详细示例

在你的 MCP Host 客户端（如 Cursor）配置文件中添加如下内容：

   {
     "mcpServers": {
       "Picui": {
         "command": "picui-mcp-server",
         "env": {
           "PICUI_TOKEN": "你的BearerToken"
         }
       }
     }
   }

- command：调用 Python 运行 server.py 脚本。 - args：填写 server.py 的绝对路径。 - env.PICUI_TOKEN：你的 Picui 个人中心获取的 Bearer Token（登录 picui.cn → 个人中心 → Token）。

> 💡 建议将此配置保存为 mcpjson.example 或直接粘贴到你的主配置文件。

🎲 10. meshy-ai-mcp-server（Meshy3D建模）

参考：meshy-ai-mcp-server 文档

🐍 安装 Python 3.9+ 和依赖

- 进入 meshy-ai-mcp-server 目录，执行：

     pip install -e .

🔑 配置 API Key

- 在 MCP 配置的 env 字段中设置：

     MESHY_API_KEY=请替换为你的Meshy API Key

- API Key 获取方法见下图： ![](./环境配置图示/meshy.png)

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "Meshy3D": {
           "command": "meshy-mcp-server",
           "env": {
             "MESHY_API_KEY": "请替换为你的Meshy API Key"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🎯 11. tripo-mcp（Tripo3D 3D建模）

参考：tripo-mcp 文档

🐍 安装 Python 3.8+ 和依赖

- 进入 tripo-mcp 目录，执行：

     pip install -e .

🔑 配置 API Key

- 在项目根目录创建 .env 文件，内容如下：

     TRIPO_API_KEY=请替换为你的Tripo3D_API_Key

- 或在 MCP 配置的 env 字段中设置。 - API Key 获取方法见下图： ![](./环境配置图示/tripo.png)

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "Tripo3D": {
           "command": "tripo-mcp-server",
           "env": {
             "TRIPO_API_KEY": "请替换为你的Tripo3D_API_Key"
           }
         }
       }
     }

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🌀 12. hunyuan3d-mcp（混元3D建模）

参考：云开发MCP Host官方文档

🟢 安装 Node.js 18+ 和 npx

- 见全局基础环境准备。

🔑 获取云开发 API KEY 和服务名

- 前往云开发平台获取 API KEY - 获取 MCP Server 的云托管服务名

以下为获取流程截图：

1. 在云开发控制台左侧选择"AI+"，点击"MCP"，在此处注册mcp server并获取云托管服务名： ![](./环境配置图示/混元0.png)

2. 点击"创建 MCP Server"，选择"腾讯混元3D"，点击"下一步"： ![](./环境配置图示/混元1.png)

3. 填写服务配置，SecretId/SecretKey 可在新建密钥获取： ![](./环境配置图示/混元2.png)

4. 在"环境配置"页面，点击"开启环境"获取云开发环境id： ![](./环境配置图示/混元3.png)

5. 在"API Key 配置"页面，点击"创建 API Key"获取token： ![](./环境配置图示/混元4.png)

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "Hunyuan3D": {
           "command": "npx",
           "args": [
             "-y",
             "@cloudbase/mcp-transformer",
             "postToStdio",
             "--url",
             "https://your-env-id.api.tcloudbasegateway.com/v1/cloudrun/your-service-name/messages",
             "--token",
             "your-token"
           ]
         }
       }
     }

上述配置中，替换以下内容：

- your-server-name: MCP Server 名称 - your-token: 在云开发平台获取的 API KEY - your-env-id: 云开发环境 ID - your-service-name: 云托管服务名

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🔧 13. instant-meshes-mcp（模型重拓扑/减面）

参考：instant-meshes-mcp 文档

🐍 安装 Python 3.8+ 和依赖以及blender3.6

- 进入 instant-meshes-mcp 目录，执行：

     pip install -e .

>如果安装失败，请检查是否安装C/C++ builder >如果提示编码问题，可以将windows全局字体改为UTF-8

- 确保 Instant Meshes.exe 放在 instant-meshes-mcp 根目录。 - 下载并安装 Blender 3.6： - 官方下载地址： - 选择适合您操作系统的版本（Windows/macOS/Linux） - 安装完成后，记录 Blender 的安装路径（如：C:\Program Files\Blender Foundation\Blender 3.6\blender.exe）

⚙️ 配置 MCP Server

- 在 MCP 客户端设置中添加如下配置：

     {
       "mcpServers": {
         "InstantMeshes": {
           "command": "instant-meshes-mcp",
           "env": {
             "PYTHONUNBUFFERED": "1",
             "BLENDER_PATH": "你的Blender3.6安装目录绝对路径"
           }
         }
       }
     }

- ⚠️ 注意：将 BLENDER_PATH 替换为实际的 Blender 安装路径，例如： - Windows: C:\\Program Files\\Blender Foundation\\Blender 3.6\\blender.exe - macOS: /Applications/Blender.app/Contents/MacOS/Blender - Linux: /usr/bin/blender 或 /opt/blender/blender

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🌄 14. polyhaven-mcp-server（Poly Haven 天空盒/模型/材质下载）

参考：[polyhaven-mcp-server 文档]

✨ 功能简介

- 支持从 Poly Haven 自动搜索和下载高质量的天空盒（HDRI）、3D模型、材质、贴图等资源。 - 支持类型：models（3D模型）、materials（材质）、hdris（天空盒）、textures（贴图）。 - 支持关键词、分类、标签等多条件本地筛选，自动评分优选。 - 下载的资源自动保存到指定目录，支持自动重命名和归档。 - 适用于Unity、Blender等3D引擎的场景搭建和美术资源管理。

🔧 安装与依赖

- Python 3.8+，依赖见 polyhaven-mcp-server/requirements.txt。 - 进入 polyhaven-mcp-server 目录，执行：

     pip install -e .

⚙️ 配置 MCP Server

- 在 MCP 客户端（如 Cursor）配置 mcp.json，添加如下内容：

     "Polyhaven": {
       "command": "polyhaven-mcp-server",
       "env": {
         "DOWNLOAD_PATH": "your download path"
       }
     }

- 说明： - DOWNLOAD_PATH：所有 Poly Haven 资源的下载保存目录，建议设置为 Unity 项目下的 Assets/Skybox 或其他资源目录，需为绝对路径。

🛠️ 工具注册与调用示例

- 搜索资产（search_assets）： - 支持按类型（models/materials/hdris/textures）、关键词、分类、标签等条件搜索。 - 返回符合条件的资产列表及详细信息。

- 下载资产（download_asset）： - 输入资产类型、slug、格式等参数，自动下载到 DOWNLOAD_PATH。 - 支持自动重命名，避免重名冲突。

- 本地评分优选： - 搜索结果可自动调用图像识别工具进行评分，优选最符合需求的资源。

- 示例： - 搜索并下载一个4K分辨率的HDR天空盒：

       搜索关键词"sunny field"的天空盒，优选评分最高的，下载4K分辨率到Assets/Skybox目录

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🌐 资源管理与规范

- 下载的所有资源均自动归档到 DOWNLOAD_PATH，并按类型/分类自动归类。 - 支持与Unity等引擎的无缝集成，下载后可直接在项目中引用。

🖼️ 15. realesrgan-mcp（图像超分辨率增强）

参考：[realesrgan-mcp 文档]

✨ 功能简介

- 图像超分辨率放大与去噪（如提升天空盒、贴图、照片等分辨率），适用于AI生成图片、天空盒等的分辨率增强。 - 可自动提升AI生成图片、天空盒、贴图等资源的分辨率至4K或更高。 - 支持与PolyHaven、MiniMax等图片生成工具配合，实现自动化高质量资源流转。

🔧 安装与依赖

- 进入 realesrgan-mcp 目录，执行：

     pip install -e .

⚙️ 配置 MCP Server

- 在 MCP 客户端（如 Cursor）配置 mcp.json，添加如下内容：

     "Realesrgan": {
       "command": "realesrgan-mcp-server"
     }

🛠️ 工具注册与调用示例

- 可通过 MCP 工具集自动调用超分辨率增强功能，无需额外 API Key。 - 推荐将下载的高分辨率图片保存到 Unity 项目资源目录（如 Assets/Skybox），以便后续自动导入。 - 常见用法： - AI生成的天空盒、贴图、照片等分辨率不够时，自动调用该服务提升至4K或更高分辨率。 - 可与 PolyHaven、MiniMax 等图片生成工具配合使用，实现自动化高质量资源流转。

🚀 启动服务

- MCP 客户端会自动调用上述命令启动服务。

🌐 资源管理与规范

- 建议将增强后的图片资源统一保存到项目资源目录，便于后续自动化流程调用和管理。

🖥️ 三、MCP Host 客户端配置（以 Cursor 为例）

打开 Cursor 设置 → Features → MCP Servers → Add new MCP server
按照上文各服务的 MCP Server 配置添加所有服务
保存后，Cursor 会自动启动并管理所有 MCP Server

❓ 四、常见问题与排查

🎯 各阶段MCP Server开启指南

为了提升性能和避免MCP Server过多导致的请求失败问题，建议按阶段开启必要的MCP Server：

🔧 阶段0-4：基础准备与Excel生成阶段

必须开启的MCP Server：

FileSimp - 路径转换和文件操作
excel - Excel文件创建和编辑

可选择性开启：

其他MCP Server暂时可以关闭，以减少系统负载

🎨 阶段5：音频与3D模型生成阶段

必须开启的MCP Server：

FileSimp - 文件重命名和路径操作
DoubaoTTS - 音频生成（主力）
JiMengAI - 图片生成
Tripo3D - 3D建模（主力）

备用MCP Server（按需开启）：

MiniMax - 音频生成备用
ElevenLabs - 音频生成备用
Meshy3D - 3D建模备用
Hunyuan3D - 3D建模备用
BaiduImageRecognition - 图片识别评分
InstantMeshes - 模型减面处理

可以关闭：

excel - 此阶段不需要Excel操作
unityMCP - 还未到Unity操作阶段

🏗️ 阶段6：模型实例化与场景布局阶段

必须开启的MCP Server：

unityMCP - Unity场景操作（核心）
FileSimp - 文件操作
Polyhaven - 天空盒资源下载

可选择性开启：

JiMengAI - 天空盒生成备用
MiniMax - 天空盒生成备用
Realesrgan - 图像超分辨率增强

可以关闭：

所有TTS相关Server（DoubaoTTS、ElevenLabs、MiniMax的TTS功能）
所有3D建模相关Server（Tripo3D、Meshy3D、Hunyuan3D）

📊 阶段7：NodeGraph创建阶段

必须开启的MCP Server：

unityMCP - NodeGraph操作

可以关闭：

除unityMCP外的所有其他MCP Server

🎬 阶段8：资产关联与Timeline生成阶段

必须开启的MCP Server：

unityMCP - Timeline和资产关联操作
excel - 读取Excel数据

可以关闭：

除unityMCP和excel外的所有其他MCP Server

⚠️ MCP Server性能警告

🚨 重要提醒：MCP Server过多导致的性能问题

当同时开启过多MCP Server（超过8-10个）时，可能出现以下问题：

请求超时：MCP Server响应变慢，工具调用失败
内存占用过高：系统资源不足，导致服务崩溃
端口冲突：多个服务竞争系统资源
连接失败：Cursor/Claude Desktop无法正常连接所有服务

🎯 解决方案：

按阶段开启：严格按照上述指南，仅开启当前阶段必需的MCP Server
及时关闭：完成某阶段后，主动关闭该阶段专用的MCP Server
监控资源：观察系统CPU和内存使用情况，适时减少服务数量
重启服务：如遇连接问题，重启Cursor并按需重新开启MCP Server

📈 推荐配置：

同时运行MCP Server数量：建议不超过5-7个
核心服务优先：优先保证unityMCP、FileSimp等核心服务稳定运行
按需激活：使用动态开启策略，需要时再启动对应服务

🔧 其他常见问题

📦 依赖未安装/版本不符：请严格按照各服务 README 要求安装依赖和指定版本。
🔑 API Key/Token 未配置：部分服务需在 .env 或 server.py 中手动填写密钥。
🔌 端口冲突/服务未启动：如遇端口占用或服务未响应，检查是否有其他进程占用，或尝试重启。
🎮 Unity 路径/权限问题：Unity 项目路径不能有空格，需有读写权限。
📊 Excel MCP 仅支持 Windows，且需本地安装 Excel。
⚠️ 常见问题：字符序列过长导致依赖安装失败

- 在 Windows 下，使用 pip install -e ".[dev]" 或安装依赖时，可能会遇到如下报错：

    ERROR: [WinError 206] 文件名或扩展名太长
    error: invalid command 'bdist_wheel'
    ...

原因说明：

- Windows 注册表的"命令行长度"默认限制为 2047 字符，某些依赖包（如 pip、setuptools、wheel 等）在安装时生成的 entry_points 超过此长度，导致写入注册表失败。

解决方法：

1. 命令行一键修复（推荐） - 以管理员身份打开 PowerShell，执行：

        Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' -Name 'Path' -Value ([Environment]::GetEnvironmentVariable('Path','Machine'))
        reg add "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v "Path" /t REG_EXPAND_SZ /d "%Path%" /f

- 或直接将注册表项类型改为 REG_EXPAND_SZ：

        reg add "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v "Path" /t REG_EXPAND_SZ /f

- 执行后重启电脑或注销当前用户。

2. 手动修改注册表 - 按 Win+R 输入 regedit，回车打开注册表编辑器。 - 定位到： 计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment - 找到右侧的 Path，右键点击，选择"修改"，将类型改为 REG_EXPAND_SZ（可扩展字符串值）。 - 保存后重启电脑。

参考资料：

- [pip install error: [WinError 206] The filename or extension is too long](https://github.com/pypa/pip/issues/4251) - StackOverflow: Windows registry Path too long

🎯 五、使用示例

🎨 生成图片：

"帮我生成一张产品logo，保存到 images 目录"

🎲 生成3D模型：

"用文本生成一个卡通小猫的3D模型"

📊 Excel 操作：

"读取你的绝对路径/你的Excel文件.xlsx 的 Sheet1 前10行数据"

🗣️ TTS 合成：

"用女声朗读'你好，欢迎使用MCP工具'，保存到指定目录"

📚 六、参考文档

如有具体服务启动报错、API Key 配置、依赖安装等问题，可根据上述文档和本地日志进行排查，或进一步咨询相关开源项目社区。

🧩 推荐/使用的 Cursor 插件

为提升本项目的开发与内容制作体验，建议在 Cursor/VSCode 环境中安装以下插件：

3D Viewer for VSCode

- 支持直接在编辑器中预览和旋转常见3D模型（如OBJ、FBX、STL等），便于快速检查模型效果。 - 可在 Cursor 内置应用商店通过名称搜索并安装。

Excel Viewer

- 允许在编辑器中直接预览和编辑Excel文件（.xlsx/.xls），适合课程流程表、物品清单等的快速查看与修改。 - 可在 Cursor 内置应用商店通过名称搜索并安装。

glTF Model Viewer

- 专为glTF/GLB格式3D模型设计的可视化插件，支持PBR材质、动画等特性，适合AI建模流程的模型预览。 - 可在 Cursor 内置应用商店通过名称搜索并安装。

Skybox Viewer

- 支持HDR、EXR、KTX2等高动态范围贴图和天空盒格式的可视化，支持jpg、jpeg、png格式图片的天空盒格式的可视化，方便美术资源和天空盒的快速预览。 - 本项目已自带本地插件，位于 Skybox_Viewer 文件夹，可直接通过 VSCode 插件管理器安装本地 .vsix 文件（Skybox_Viewer/skybox-viewer-0.0.2.vsix）。 - 该插件未在应用商店发布，仅支持本地安装。

SpecStory

- 用于交互式流程规范、需求文档和自动化脚本的可视化与管理，适合课程制作流程的规范化管理。 - 可在 Cursor 内置应用商店通过名称搜索并安装。

建议在使用本项目时，提前安装上述插件，以获得最佳的开发、预览和管理体验。

MCP Course Maker

快速接入

详细介绍

🎓 MCP-Course-Maker

🌍 一、全局基础环境准备

🐍 1. Python

🟢 2. Node.js & npm

⚡ 3. uv 包管理器

🔧 4. 其他依赖

🖥️ 二、各子包详细环境配置步骤

🎮 1. unitymcp（Unity 编辑器自动化）

📊 2. excel-mcp-server（Excel 读写）

📁 3. file-simp-server（文件自动重命名和压缩解压工具 FileSimp MCP Server）

🗣️ 4. doubaomcp（豆包TTS，火山引擎 TTS）

🎤 5. elevenlabs-mcp（ElevenLabs TTS）

🤖 6. MiniMax（AI 生成/对话/多模态）

🎨 7. image-gen-server-main（即梦AI图像生成）

🖼️ 8. baidu-image-recognition-mcp（百度图像识别 MCP 工具）

🖼️ 9. picui-image-upload-mcp（Picui 图床 MCP Server）

🎲 10. meshy-ai-mcp-server（Meshy3D建模）

🎯 11. tripo-mcp（Tripo3D 3D建模）

🌀 12. hunyuan3d-mcp（混元3D建模）

🔧 13. instant-meshes-mcp（模型重拓扑/减面）

🌄 14. polyhaven-mcp-server（Poly Haven 天空盒/模型/材质下载）

🖼️ 15. realesrgan-mcp（图像超分辨率增强）

🖥️ 三、MCP Host 客户端配置（以 Cursor 为例）

❓ 四、常见问题与排查

🎯 各阶段MCP Server开启指南

🔧 阶段0-4：基础准备与Excel生成阶段

🎨 阶段5：音频与3D模型生成阶段

🏗️ 阶段6：模型实例化与场景布局阶段

📊 阶段7：NodeGraph创建阶段

🎬 阶段8：资产关联与Timeline生成阶段

⚠️ MCP Server性能警告

🔧 其他常见问题

🎯 五、使用示例

📚 六、参考文档

🧩 推荐/使用的 Cursor 插件

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP