Lumverse MCP

Lumverse MCP是一个连接Lumverse Engine和Claude AI的Model Context Protocol实现，让Claude AI能够操作和创建3D场景。

功能介绍

Lumverse MCP提供以下主要功能：

• 场景信息：获取和查询Lumverse场景与对象信息
• 3D对象操作：创建、修改和删除3D对象
• 材质管理：设置对象材质和颜色
• 代码执行：在Lumverse环境中执行任意Python代码

系统要求

• Python 3.8+
• Lumverse Engine (需在本地运行，监听9527端口)

安装指南

Windows环境

1. 克隆或下载本仓库
2. 运行setup_env.bat脚本创建虚拟环境并安装依赖：

setup_env.bat

安装过程中可以选择使用UV包管理器来加速依赖安装。

Linux/Mac环境

1. 克隆或下载本仓库
2. 运行setup_env.sh脚本创建虚拟环境并安装依赖：

chmod +x setup_env.sh
./setup_env.sh

安装过程中可以选择使用UV包管理器来加速依赖安装。

手动安装UV(可选)

如果您希望在现有环境中单独安装UV包管理器，可以按照以下步骤操作：

# 使用pip安装UV
pip install uv

# 使用UV安装依赖
uv pip install -r requirements.txt

UV是一个更快的Python包管理工具，使用Rust编写，可以显著提高依赖安装速度。

启动服务器

Windows环境

使用以下方法之一启动服务器：

run_lumverse_mcp.bat

2. 使用基本启动脚本：

start_server.bat

3. 或手动启动：

call .venv\Scripts\activate.bat
python lumverse_mcp.py

Linux/Mac环境

source .venv/bin/activate
python lumverse_mcp.py

API工具

Lumverse MCP提供以下API工具供Claude AI使用：

场景信息

• get_scene_info() - 获取当前场景的详细信息
• get_object_info(object_name) - 获取特定对象的详细信息

对象操作

• create_object(type, name, location, rotation, scale) - 创建新对象
• modify_object(name, location, rotation, scale, visible) - 修改现有对象
• delete_object(name) - 删除对象

材质管理

• set_material(object_name, material_name, color) - 设置或创建材质

代码执行

• execute_lumverse_code(code) - 执行任意Python代码

连接架构

Lumverse MCP通过TCP Socket与Lumverse Engine建立连接，使用JSON格式进行通信。该服务使用Model Context Protocol框架，提供一个可靠的接口供Claude AI调用。

故障排除

如遇连接问题，请确保：

1. Lumverse Engine已在本地启动服务端并监听9527端口
2. 没有防火墙阻止本地连接
3. 虚拟环境中已安装所有依赖

在Cursor IDE中使用

要在Cursor IDE中调用Lumverse MCP，请按照以下步骤操作：

1. 打开MCP Servers配置："文件" -> "首选项" -> "Cursor Setting" -> "MCP" -> "添加MCP服务器"

2. 打开 cmp.json 文件：添加 { "mcpServers": { "lumverse": { "command": "you\dir\run_lumverse_mcp.bat", "args": [ ] } } }

示例提示：

使用Lumverse创建一个红色立方体，位置在(0,0,0)，并将其旋转45度

5. 高级使用：
   • 可以结合Claude的文本生成能力与Lumverse的3D功能创建复杂场景
   • 支持迭代式场景构建和修改

注意：确保Lumverse Engine和MCP服务器都在运行状态，才能在Cursor中成功调用API。

许可证

[添加您的许可证信息]

联系方式

[添加联系方式信息]