MCP 服务器

AiSpire

针对 Vectric Aspire/V-Carve 的 MCP 服务器和插件

CompewterTutor

开发者工具

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 Gadget - 一个在 Vectric Aspire/V-Carve 环境中运行的插件
Python MCP Server - 一个实现用于 LLM 集成的模型上下文协议的服务器

                 ┌─────────────┐            ┌─────────────┐            ┌─────────┐
                 │             │            │             │            │         │
                 │    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 Server: 具有命令处理管道的基本套接字服务器
Command Processing: 用于执行 Lua 代码和 SDK 函数的框架
UI Manager: 具有日志查看器和命令历史记录的交互式用户界面
Helper Functions: 用于常见操作的综合库
Python MCP Server: 具有套接字客户端的基本 MCP 协议实现

UI 特性

AiSpire Gadget 包括一个全面的用户界面：

Log Viewer: 实时显示系统消息，并具有颜色编码的严重性级别
Command History: 查看和重播过去的命令，并带有成功/失败指示器
History Management: 保存和加载命令历史记录以供将来参考
Connection Status: 显示连接状态和活动的视觉指示器
Disconnect Controls: 通过确认对话框安全断开连接

UI 可以通过两种方式访问：

主要 gadget 操作启动带有 UI 的服务器
二级操作（“Show AiSpire Control Panel”）仅打开 UI，而不重新启动服务器

目录结构

lua_gadget/ - Vectric 软件的 Lua 插件
- server.lua - 套接字服务器实现
- ui_manager.lua - gadget 的 UI 实现
- json.lua - JSON 解析实现
- helpers/ - 用于常见操作的辅助函数
python_mcp_server/ - MCP 服务器的 Python 实现
tests/ - 两个组件的测试文件
docs/ - 项目文档
- vectric_sdk/ - 包含详细的 Vectric SDK 参考文档
llm_brain/ - AI 开发指南和项目记忆

开始使用

即将推出 - 第一个功能版本可用时，将提供安装和使用说明。

构建和测试

该项目包括一个 Makefile，其中包含用于构建和测试的各种命令：

# 安装开发依赖项
make install-dev-deps

# 运行所有测试
make test

# 运行特定的测试套件
make test-all-lua     # 运行所有 Lua 测试
make test-all-python  # 运行所有 Python 测试
make test-e2e         # 运行端到端测试

# 更精细的测试选项
make test-lua          # 在 tests/lua_tests/ 中运行 Lua 测试
make test-lua-helpers  # 运行 Lua 辅助函数测试
make test-python-core  # 运行 Python 核心测试
make test-python-mcp   # 运行 Python MCP 服务器测试
make test-python-tests # 运行 tests/python_tests 中的测试

# 创建 Vectric gadget 捆绑包
make bundle

# 显示所有可用命令
make help