内容
# Meshy AI 连接器
一个MCP（模型上下文协议）服务器，将 [Meshy AI](https://www.meshy.ai) 的文本到3D和图像到3D生成功能引入Claude Desktop、Claude Code和Cowork，作为Claude可以直接调用的原生工具。
向Claude请求一个3D模型，它可以生成预览，完善纹理，绑定，动画，并将完成的GLB/FBX/OBJ/USDZ文件下载到您的机器上 - 无需单独的应用程序，无需手动API调用。
[](LICENSE)
[](package.json)
[](tsconfig.json)
## 为什么存在
Meshy AI有一个可靠的REST API用于文本/图像到3D生成，但没有一种直接的方式可以从AI助手的工具调用循环中驱动它。该项目将该API封装为MCP服务器，更重要的是，它封装在**提供者无关的架构** (`IAI3DProvider`)后面，这样其他3D生成API（Tripo，Rodin，Luma，Trellis，...）可以在不触及编排逻辑，凭证处理，下载管道或MCP工具表面的情况下稍后添加。
它是为 [AttrangiToys](https://github.com/honeyashu) 构建的，这是一个使用AI生成的3D资产的玩具设计工作室，但它故意与该项目解耦 - 任何将Meshy AI与Claude集成的用户都可以直接使用它。
## 功能
- **生成** - 文本到3D（预览→完善纹理）和图像到3D（单张或最多4张多视角图像）
- **绑定和动画** - 人形自动绑定，然后从Meshy的动作库应用动画
- **跟踪作业** - 轮询状态/进度，取消，列出活动作业，可选的SQLite支持重启后持久化
- **下载** - 并发多格式下载（GLB/FBX/OBJ/USDZ/STL/3MF），每个作业的磁盘布局，可选的Draco GLB压缩和ZIP打包
- **安全凭证管理** - API密钥静态加密（AES-256-GCM），绝不以明文记录
上述所有功能都暴露为14种MCP工具 - 有关完整的API参考和架构深入解析，请参见 [MESHY_CONNECTOR.md](./MESHY_CONNECTOR.md)。
## 快速开始
```bash
git clone https://github.com/honeyashu/MeshyAI_MCP_Connector.git
cd MeshyAI_MCP_Connector/meshy-ai-connector
npm install
npm run build
```
将其添加到您的MCP客户端配置中。对于Claude Desktop，请编辑 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"meshy-ai": {
"command": "node",
"args": ["/absolute/path/to/MeshyAI_MCP_Connector/meshy-ai-connector/dist/server/mcpServer.js"]
}
}
}
```
重启您的客户端，然后要求Claude使用您的 [Meshy API密钥](https://www.meshy.ai/api-keys)（以 `msy_` 开头）调用 `save_credentials` 工具。这是仅需执行一次的步骤 - 密钥将被加密并存储在本地。从那里，只需要求Claude生成内容：“生成一个3D陶瓷玩具车的模型，然后将其下载到 ~/Desktop/models。”
完整的设置，配置选项（下载目录，大小预算，压缩，日志记录）和故障排除都在 [MESHY_CONNECTOR.md](./MESHY_CONNECTOR.md) 中。
## 项目布局
```
meshy-ai-connector/
├── src/
│ ├── core/ # 提供者无关的编排（GenerationManager，DownloadManager，CredentialManager，RetryPolicy，Logger，types）
│ ├── providers/meshy/ # Meshy AI 实现的 IAI3DProvider
│ ├── store/ # 加密凭证存储 + 可选的 SQLite 作业存储
│ └── server/ # mcpServer.ts - MCP 入口点，14 个注册工具
├── MESHY_CONNECTOR.md # 完整的开发者指南：API 参考，配置，架构，已知缺陷
└── README.md # 你在这里
```
## 状态
所有核心阶段都已完成：142/142 测试通过，严格的TypeScript，零 `tsc`/`eslint` 错误，MCP服务器已针对真实的 `@modelcontextprotocol/sdk` 进行验证。两个已知的，已文档化的缺陷仍然存在 - 请参见开发者指南中的 [已知缺陷和限制](./MESHY_CONNECTOR.md#known-gaps--limitations) （两者都不妨碍正常使用）。
## 贡献
欢迎贡献 - 错误修复，第二个提供者实现，更好的测试覆盖率，文档改进，等等。请参见 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解代码库的组织方式和好的PR的样子。简而言之：fork，branch off `main`，在打开PR之前运行 `npm run typecheck && npm run lint && npm test`。
如果您正在添加新的3D生成提供者（Tripo，Rodin，Luma等）， [MESHY_CONNECTOR.md](./MESHY_CONNECTOR.md#adding-a-new-provider) 介绍了要遵循的确切模式。
## 许可证
[MIT](./LICENSE) - 您可以任意使用，包括fork和商业用途。
