使用说明

项目简介

3D-MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 3D 数字内容创作 (DCC) 软件（如 Blender、Maya、Unreal Engine）提供统一的语义接口。它充当 LLM 和 3D 软件之间的桥梁，使得 LLM 可以通过标准化的方式理解和控制各种 3D 操作。

主要功能点

• 提供动画工具集，用于创建、编辑和控制 3D 动画。
• 提供渲染工具集，用于配置和执行 3D 渲染任务。
• 使用 Zod 进行数据验证，确保数据类型的正确性。
• 基于 'fastmcp' 库构建，实现 MCP 协议，支持通过 stdio 传输协议与 MCP 客户端通信。

安装步骤

bun install

服务器配置

{
  "serverName": "3D-MCP Server",
  "command": "bun",
  "args": ["run", "index.ts"]
}

• 'serverName': 服务器名称，可以自定义。
• 'command': 启动服务器的命令，这里使用 'bun' 运行时。
• 'args': 传递给 'bun' 命令的参数，'run index.ts' 表示运行项目根目录下的 'index.ts' 文件。

基本使用方法

1. 确保已安装 Bun 运行时环境。
2. 克隆仓库代码到本地。
3. 在仓库根目录下执行 'bun install' 安装依赖。
4. 启动 MCP 服务器。
5. 配置 MCP 客户端连接到该服务器 (使用 stdio 传输协议)。
6. 通过 MCP 客户端向服务器发送请求，调用预定义的 3D 工具，例如动画工具或渲染工具。