Lumverse MCP

April 10, 2025 · View on GitHub

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
  1. 使用基本启动脚本：
start_server.bat
  1. 或手动启动：
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度
  1. 高级使用：
    • 可以结合Claude的文本生成能力与Lumverse的3D功能创建复杂场景
    • 支持迭代式场景构建和修改

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

许可证

[添加您的许可证信息]

联系方式

[添加联系方式信息]