MeshLab MCP
MeshLab的最小可扩展模型上下文协议（MCP）桥，使用FastAPI（HTTP）和自定义TCP（JSON）后端进行网格操作，通过 pymeshlab.
______________________________________________________________________
特性
- HTTP API 使用FastAPI的MCP客户端（web UI、编排器）
- TCP（JSON）后端 与MeshLab进程通信（使用
pymeshlab) - 可扩展：轻松添加新的网格工具和协议命令
______________________________________________________________________
项目结构
MeshLab-mcp/
├── meshlab_tcp_server.py # TCP server wrapping pymeshlab
├── meshlab_tcp_client.py # TCP client for server communication
├── meshlab_mcp.py # Core MCP protocol logic (extensible)
├── mcp_server.py # FastAPI HTTP server (entrypoint)
├── mcp_client.py # HTTP client for testing
├── requirements.txt
└── README.md______________________________________________________________________
安装说明
- 克隆存储库 和
cd进入目录。
- 安装依赖项：
pip install -r requirements.txt- 将Python脚本目录添加到PATH （如果还没有）：
- 例子： C:\Users\\AppData\Roaming\Python\Python313\Scripts\ - 更改PATH后重新启动终端。
- 启动MeshLab TCP服务器 （在终端中）：
python meshlab_tcp_server.py- 启动HTTP MCP服务器 （在另一个终端中）：
python -m uvicorn mcp_server:app --reload> 如果 uvicorn 无法识别，请使用完整路径或 python -m uvicorn ... 形式如上。
- 使用HTTP客户端进行测试 （可选）：
python mcp_client.py您应该看到如下输出：
{'mesh_loaded': False, 'current_mesh_name': None}______________________________________________________________________
MCP客户端配置示例（用于MeshLab集成）
要将MeshLab（或编排器）连接到此MCP服务器，请使用以下配置：
{
"mcpServers": {
"meshlab": {
"command": "uvx",
"args": [
"meshlab-mcp"
],
"host": "127.0.0.1",
"port": 8000
}
}
}command：启动MCP HTTP服务器的命令（例如。，uvx meshlab-mcp或python -m uvicorn mcp_server:app --reload)host/port：可访问HTTP API的位置。
______________________________________________________________________
运作原理
- MCP客户端 （web UI、编排器）向FastAPI服务器发送HTTP请求。
- FastAPI服务器将这些请求桥接到MeshLab TCP服务器（该服务器使用
pymeshlab). - TCP服务器以JSON结果进行响应。
______________________________________________________________________
延伸
- 在中添加新的网格工具/命令
meshlab_tcp_server.py并在协议中公开它们。 - 在中添加相应的方法
meshlab_tcp_client.py以及新的HTTP端点mcp_server.py.
______________________________________________________________________
故障排除
- 如果
uvicorn无法识别，请确保您的Python脚本目录在PATH中或使用python -m uvicorn .... - 始终在启动HTTP服务器之前启动TCP服务器。
- 对于网格操作，请确保网格文件存在于工作目录中。
______________________________________________________________________
后续步骤
- 开始构建新的网格工具和协议命令！
- 有关与MeshLab的GUI或其他工具的高级集成，请参阅MeshLab的文档和MCP规范。
______________________________________________________________________
如果您有任何疑问或想添加新功能，请随时提问！
