mcpField
A
AiSpire

AiSpire

本地服务
github.com/CompewterTutor媒体与设计681 周前更新

关于 AiSpire

AiSpire 通过 Lua 插件和 Python MCP 服务将 Vectric Aspire 或 V-Carve 接入 LLM,提供设计操作与 CNC 刀具路径生成能力;项目仍在开发中。

主要功能

  1. 01在 Vectric 软件中执行 Lua 代码
  2. 02创建和编辑矢量路径与文本
  3. 03导入并修改 3D 模型
  4. 04生成 CNC 刀具路径
  5. 05查看日志并重放命令历史

适用场景

  1. 01在 Vectric 中创建矢量设计
  2. 02以编程方式修改 3D 模型
  3. 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 由两个主要组件构成:

  1. Lua 插件 - 用于 Vectric Aspire/V-Carve 的插件,在 CAD/CAM 环境中运行
  2. 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:

  1. 主插件操作会启动服务和 UI
  2. 次要操作(“显示 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 参考,我们计划实现:

  1. 高级几何运算:基于矩阵的变换、复杂路径创建和极坐标函数
  2. 专业作业管理:支持双面和旋转作业
  3. 全面的刀具路径策略:轮廓加工、凹槽加工、V 形雕刻、刻槽、棱柱雕刻、3D 粗加工和精加工
  4. 刀具数据库集成:访问系统刀具数据库、创建自定义刀具
  5. UI 集成:自定义对话框、进度条、文件选择界面
  6. 系统集成:应用程序检测、文件位置访问、注册表设置
  7. 外部刀具路径支持:生成、导入和导出自定义刀具路径

许可证

许可证信息待定

联系方式

联系信息待提供

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。