关于 AiSpire
AiSpire 通过 Lua 插件和 Python MCP 服务将 Vectric Aspire 或 V-Carve 接入 LLM,提供设计操作与 CNC 刀具路径生成能力;项目仍在开发中。
主要功能
- 01在 Vectric 软件中执行 Lua 代码
- 02创建和编辑矢量路径与文本
- 03导入并修改 3D 模型
- 04生成 CNC 刀具路径
- 05查看日志并重放命令历史
适用场景
- 01在 Vectric 中创建矢量设计
- 02以编程方式修改 3D 模型
- 03生成用于 CNC 加工的刀具路径
MCP 相关
Python MCP 服务通过套接字将 LLM 客户端连接到 Vectric 软件中的 Lua 插件,并开放命令和 SDK 操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
.oo o .oPYo. o
.P 8 8
.P 8 o8 `Yooo. .oPYo. o8 oPYo. .oPYo.
oPooo8 8 `8 8 8 8 8 `' 8oooo8
.P 8 8 8 8 8 8 8 8.
.P 8 8 `YooP' 8YooP' 8 8 `Yooo'
..:::::..:..:.....:8 ....::....:::::.....:
:::::::::::::::::::8 :::::::::::::::::::::
:::::::::::::::::::..:::::::::::::::::::::
AiSpire
AiSpire 是 Vectric Aspire 和 V-Carve CAD/CAM 软件的智能接口,可实现由 AI 驱动的设计与加工功能。
概述
AiSpire 由两个主要组件构成:
- Lua 插件 - 用于 Vectric Aspire/V-Carve 的插件,在 CAD/CAM 环境中运行
- Python MCP 服务 - 实现模型上下文协议、用于集成大模型的服务
┌─────────────┐ ┌─────────────┐ ┌─────────┐
│ │ │ │ │ │
│ LLMs │◄─────────► │ Python MCP │◄─────────► │ Lua │
│ │ (MCP) │ Server │ (Socket) │ Gadget │
│ │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────┘
│
│
▼
┌─────────────┐
│ Vectric │
│ Aspire/ │
│ V-Carve │
└─────────────┘
功能
- 在 Vectric 软件中执行任意 Lua 代码
- 以编程方式创建和操作矢量路径
- 导入和修改 3D 模型
- 绘制矢量图形和文本
- 优化矢量排版,以提高材料利用率
- 生成并计算用于 CNC 加工的刀具路径
- 交互式 UI,支持查看日志和命令历史记录
- 利用高级 Vectric SDK 功能:
- 使用矩阵变换精确操作对象
- 特殊作业类型(双面、旋转)
- 高级刀具路径策略(V 型雕刻、槽铣、棱柱雕刻)
- 集成刀具数据库
- 自定义 UI 元素(HTML 对话框、进度条)
- 外部刀具路径的生成、导入和导出
项目状态
AiSpire 目前正在积极开发中。关键组件已实现:
- Lua Socket 服务:具备命令处理流水线的基础 Socket 服务
- 命令处理:用于执行 Lua 代码和 SDK 函数的框架
- UI 管理器:带日志查看器和命令历史记录的交互式用户界面
- 辅助函数:用于常见操作的综合函数库
- Python MCP 服务:采用 Socket 客户端的基础 MCP 协议实现
UI 功能
AiSpire Gadget 包含完善的用户界面:
- 日志查看器:实时显示系统消息,并按严重程度以不同颜色标识
- 命令历史记录:查看并重放过去的命令,并显示成功或失败状态
- 历史记录管理:保存和加载命令历史记录,以供日后参考
- 连接状态:通过可视指示器显示连接状态和活动情况
- 断开连接控件:通过确认对话框安全断开连接
可通过两种方式访问 UI:
- 主插件操作会启动服务和 UI
- 次要操作(“显示 AiSpire 控制面板”)仅打开 UI,而不会重启服务
目录结构
lua_gadget/- 用于 Vectric 软件的 Lua 插件server.lua- Socket 服务实现ui_manager.lua- 插件的 UI 实现json.lua- JSON 解析实现helpers/- 用于常见操作的辅助函数
python_mcp_server/- MCP 服务的 Python 实现tests/- 两个组件的测试文件docs/- 项目文档vectric_sdk/- 包含详细的 Vectric SDK 参考文档
llm_brain/- AI 开发指南和项目记忆
快速开始
即将推出——首个可用版本发布后将提供安装和使用说明。
构建和测试
项目包含一个 Makefile,其中提供了用于构建和测试的各种命令:
# Install development dependencies
make install-dev-deps
# Run all tests
make test
# Run specific test suites
make test-all-lua # Run all Lua tests
make test-all-python # Run all Python tests
make test-e2e # Run end-to-end tests
# More granular test options
make test-lua # Run Lua tests in tests/lua_tests/
make test-lua-helpers # Run Lua helper tests
make test-python-core # Run Python core tests
make test-python-mcp # Run Python MCP server tests
make test-python-tests # Run tests in tests/python_tests
# Create Vectric gadget bundle
make bundle
# Show all available commands
make help
要求
- Vectric Aspire 或 V-Carve 软件
- Lua 5.3+ 和 LuaSocket 库
- Python 3.8+ 及所需软件包(待
requirements.txt提供后参阅) - 可访问支持模型上下文协议的大模型
SDK 参考
项目包含一份完善的 Vectric SDK 参考文档(位于 docs/vectric_sdk/Vectric.lua),记录了与 Vectric Aspire/V-Carve 交互时可用的函数。该参考涵盖:
- 作业创建和管理
- 矢量和几何操作
- 使用各种策略生成刀具路径
- 刀具数据库访问
- 用户界面元素
- 3D 组件操作(仅 Aspire)
- 系统信息和注册表访问
计划中的增强功能
根据详细的 SDK 参考,我们计划实现:
- 高级几何运算:基于矩阵的变换、复杂路径创建和极坐标函数
- 专业作业管理:支持双面和旋转作业
- 全面的刀具路径策略:轮廓加工、凹槽加工、V 形雕刻、刻槽、棱柱雕刻、3D 粗加工和精加工
- 刀具数据库集成:访问系统刀具数据库、创建自定义刀具
- UI 集成:自定义对话框、进度条、文件选择界面
- 系统集成:应用程序检测、文件位置访问、注册表设置
- 外部刀具路径支持:生成、导入和导出自定义刀具路径
许可证
许可证信息待定
联系方式
联系信息待提供
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。