使用说明

项目简介

Tripo MCP Server 作为一个基于 Model Context Protocol (MCP) 的服务器，旨在连接 AI 助手（如 Claude 和 Cursor）与 3D 内容创作工具（Tripo AI 和 Blender）。它允许用户在支持 MCP 协议的 AI 环境中，通过自然语言指令，控制 Blender 并利用 Tripo AI 的能力生成 3D 资产。

主要功能点

3D 模型生成与导入: 通过 Tripo AI 的 API，根据自然语言描述生成 3D 模型，并自动导入到 Blender 中。
Blender 场景互动: 提供工具集，允许 AI 助手查询 Blender 场景信息，创建、修改、删除场景中的 3D 对象，以及设置材质等。
PolyHaven 资源库集成: 集成 PolyHaven 资源库，支持搜索、下载和导入 HDRI、纹理和模型等资源到 Blender。
代码执行: 支持在 Blender 中执行 Python 代码，实现更高级和定制化的操作。

安装步骤

安装 Python: 确保已安装 Python 3.10 或更高版本。
安装 Blender 和 Tripo AI Blender 插件:
- 下载并安装 Blender。
- 从 Tripo AI 官网下载并安装 Tripo AI Blender 插件。
配置 MCP 服务器: 在支持 MCP 协议的 AI 客户端（如 Claude Desktop 或 Cursor IDE）中配置 MCP 服务器连接。

服务器配置

MCP 客户端需要以下 JSON 配置信息来连接 Tripo MCP Server：

{
  "server_name": "Tripo MCP Server",
  "command": "python",
  "args": ["main.py"]
}

'server_name': MCP 服务器的名称，可以自定义，用于在客户端中标识。
'command': 启动服务器的命令，这里使用 'python' 解释器。
'args': 传递给 'python' 命令的参数，即服务器主程序 'main.py' 的文件名。请确保在仓库的根目录下启动 MCP 服务器。

基本使用方法

启动 Tripo MCP Server：在仓库根目录下，使用终端运行配置中的启动命令 'python main.py'。
在 MCP 客户端中配置并连接到 Tripo MCP Server。
在 AI 助手中使用自然语言指令，例如：
- 'Generate a 3D model of a futuristic chair' (生成未来主义椅子的 3D 模型)
- 'Get information about the object named 'Cube'' (获取名为 'Cube' 的对象信息)
- 'Search for wooden textures on PolyHaven' (在 PolyHaven 上搜索木质纹理)

注意: 使用 Tripo AI 功能（如 'create_3d_model_from_text' 和 'get_task_status' 工具）可能需要配置 Tripo API 密钥。请确保 Blender 中 Tripo AI 插件已正确配置 API 密钥。

关键词