Meshy AI MCP Server

基本能力

产品定位

Meshy AI MCP Server 是一个专注于 3D 模型生成和处理的工具，通过与 Meshy AI API 的交互，提供从文本或图像生成 3D 模型的能力，以及对现有模型进行纹理应用和网格优化的功能。

核心功能

• 从文本提示生成 3D 模型
• 从图像生成 3D 模型
• 为 3D 模型应用纹理
• 重新网格化和优化 3D 模型
• 实时流式传输任务进度
• 列出和检索任务
• 检查账户余额

适用场景

• 3D 设计师需要快速生成原型模型
• 游戏开发者需要为游戏资产生成 3D 模型
• 教育工作者创建教学用的 3D 模型
• 艺术家探索创意概念的可视化

工具列表

创建工具

• create_text_to_3d_task: 从文本提示生成 3D 模型
• create_image_to_3d_task: 从图像生成 3D 模型
• create_text_to_texture_task: 使用文本提示为 3D 模型应用纹理
• create_remesh_task: 重新网格化和优化 3D 模型

检索工具

• retrieve_text_to_3d_task: 获取文本到 3D 任务的详细信息
• retrieve_image_to_3d_task: 获取图像到 3D 任务的详细信息
• retrieve_text_to_texture_task: 获取文本到纹理任务的详细信息
• retrieve_remesh_task: 获取重新网格化任务的详细信息

列表工具

• list_text_to_3d_tasks: 列出文本到 3D 任务
• list_image_to_3d_tasks: 列出图像到 3D 任务
• list_text_to_texture_tasks: 列出文本到纹理任务
• list_remesh_tasks: 列出重新网格化任务

流式工具

• stream_text_to_3d_task: 流式传输文本到 3D 任务的更新
• stream_image_to_3d_task: 流式传输图像到 3D 任务的更新
• stream_text_to_texture_task: 流式传输文本到纹理任务的更新
• stream_remesh_task: 流式传输重新网格化任务的更新

实用工具

• get_balance: 检查 Meshy AI 账户余额

常见问题解答

• 需要 Meshy AI API 密钥才能使用服务
• 可以通过环境变量配置服务器端口和任务超时时间
• 开发模式下可以使用 MCP 检查器监控通信

使用教程

使用依赖

1. 克隆仓库: bash git clone https://github.com/pasie15/scenario.com-mcp-server cd meshy-ai-mcp-server

2. 设置虚拟环境: 使用 venv: bash python -m venv .venv # Windows .\.venv\Scripts\activate # macOS/Linux source .venv/bin/activate

使用 Conda: bash conda create --name meshy-mcp python=3.9 conda activate meshy-mcp

安装教程

1. 安装 MCP 包: bash pip install mcp

2. 安装依赖: bash pip install -r requirements.txt

3. 创建 .env 文件并添加 Meshy AI API 密钥: bash cp .env.example .env # 编辑 .env 文件添加 API 密钥

调试方式

• 启动服务器: bash python src/server.py 或使用 MCP CLI: bash mcp run config.json

• 开发模式(启动检查器): bash mcp dev src/server.py 检查器将在 http://127.0.0.1:6274 运行

许可证

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