光波MCP服务器
A. 模型上下文协议（MCP） 服务器，提供对LightWave3D命令端口功能的访问。这使得像Cursor这样的AI助手能够以编程方式发现、连接和控制LightWave Modeler和Layout。
什么是MCP？
如果MCP对你来说是一个新术语：MCP服务器允许几乎任何程序或脚本工具以一种你可以使用英语会话自动化几乎任何事情的方式进行包装。这是一个强大的选项，可以使用简单的提示以“低代码”的方式帮助驯服复杂的工作流任务。
截图
以下是使用 光标 编辑。提示用于通过称为LightWave命令端口的远程控制接口驱动活动的LightWave3D会话。
特性
- 自动发现：使用UDP广播查找网络上正在运行的LightWave实例
- 双接口支持：连接到LightWave布局和建模器
- 指挥反思：857个布局命令和63个建模器命令的预构建缓存
- 动态更新：当LightWave使用新的API功能更新时刷新命令缓存
- 连接管理：跟踪和管理多个活动连接
- Python 3兼容：包括分叉
lwcommandport库已更新为Python 3.11+
安装
先决条件
- Python 3.7+（用Python 3.11+测试）
- 启用命令端口的LightWave 3D 2025.0.3+
快速开始
- 使用“git clone”或GitHub Repo“Code”按钮下载存储库：
- 克隆此存储库：
git clone https://github.com/Kartaverse/lightwave-mcp.git
cd lightwave-mcp- 或者，您可以单击 光波mcp GitHub仓库的绿色“代码”按钮，然后选择“下载ZIP”按钮。您需要手动展开“lightwavemcp-master.zip”存档。将文件夹从“lightwave mcp master”重命名为“lightwave mcp”。
- 配置 mcp.json 在您首选的MCP客户端（例如Cursor）中设置。在“光标设置>工具和MCP>安装MCP服务器”部分，单击“新建MCP服务器”按钮。
这将打开 .cursor/mcp.json 在新的游标选项卡中编辑文件。添加以下文本，同时确保保留任何预先存在的MCP条目和这些预先存在的项目的JSON标识级别。
{
"mcpServers": {
"lightwave-mcp": {
"command": "python3",
"args": [
"/path/to/lightwave-mcp/src/lightwave_mcp/server.py"
],
"env": {
"PYTHONPATH": "/path/to/lightwave-mcp/src"
}
}
}
}您需要更新mcp.json文件中的绝对文件路径，以指向 lightwave-mcp 文件已下载。如果你在Windows上，你可能不得不使用双斜杠。”\\“用于mcp.json文件路径中的每个文件夹路径分隔符，以正确处理json文档中的字符串转义。
如果您的Python v3.x可执行文件未命名为“python3“当您从CLI会话运行python时，可以更改 mcp.json 基于lightwave mcp“command”条目引用名为“python".
当此更新内容添加到您的 .cursor/mcp.json 在Cursor GUI中，它应该看起来像这样：
“光标设置>工具和MCP>已安装的MCP服务器”部分应列出“光波MCP”项。如果单击“lightwave mcp”项的标题，将显示各个工具。
- 从提供的中复制光波mcp示例规则内容 规则.md 将文件放入“光标设置>规则、技能、子代理>规则”部分。按下
Save按钮以保留新规则。
可用工具
| 工具 | 说明 |
|---|---|
discover_lightwave | 在网络上查找正在运行的LightWave实例 |
connect_layout | 连接到LightWave Layout实例 |
connect_modeler | 连接到LightWave建模器实例 |
connect_layout_auto | 自动发现并连接到布局 |
connect_modeler_auto | 自动发现并连接到Modeler |
send_layout_command | 向连接的布局发送命令 |
send_modeler_command | 向连接的Modeler发送命令 |
list_connections | 列出所有活动连接 |
close_connection | 关闭活动连接 |
list_layout_commands | 列出所有布局命令 |
list_modeler_commands | 列出所有建模器命令 |
refresh_command_cache | 从模块刷新命令缓存 |
示例工作流程
- 发现LightWave实例:
discover_lightwave()- 连接到布局:
connect_layout(address="localhost", port=50155)- 发送命令:
send_layout_command(command="About", args=[])
send_layout_command(command="SelectItem", args=["30000000"])- 关闭连接:
close_connection(connection_id="...")默认连接行为
连接到LightWave实例后，服务器会记住该连接。后续命令可以省略 connection_id 当只有一个这种类型的连接存在时。
| 场景 | 行为 |
|---|---|
| 一个布局连接处于活动状态 | connection_id 自动解析 |
| 一个Modeler连接处于活动状态 | connection_id 自动解析 |
| 多个连接处于活动状态 | 您必须指定哪一个 |
| 没有匹配的连接 | 错误：使用 connect_layout 或 connect_modeler 首先 |
命令缓存
服务器附带了预构建的命令缓存：
- 布局：857个命令
- 建模师：63个命令
要在LightWave更新时更新缓存，请执行以下操作：
cd lightwave-mcp/src
python3 introspect_commands.py -o ../cache或使用MCP工具：
refresh_command_cache(module_path="/Applications/LightWaveDigital/LightWave3D_2025.0.3/support/python")协议细节
- 运输：stdio（标准输入/输出）
- 发现端口：50155-50165（UDP广播）
- 协议版本: 1.0
光波命令端口
LightWave命令端口是内置于LightWave 3D中的基于UDP的进程间通信系统。
| 组件 | 目的 |
|---|---|
| 布局 | 场景编排、动画、渲染 |
| 建模师 | 三维多边形建模、网格编辑 |
许可证
lightwave-mcp 根据Apache 2.0许可证发布。它是由以下成员创建的工作流自动化原型 Windows 子系统 for Linux LightWave3D社区。
lwcommandport版权所有（c）LightWave Digital，LTD.保留所有权利。包括 lwcommandport 该库是原始LightWave SDK示例代码的分支，已更新以兼容Python 3。
支持
对于与 lightwave-mcp MCP服务器，请在存储库上打开一个问题。