mcpField
A
AiSpire

AiSpire

Local
github.com/CompewterTutorMedia & Design6Updated 81w ago
Repository

About AiSpire

AiSpire links Vectric Aspire or V-Carve with an LLM through a Lua gadget and Python MCP server. It provides programmatic access to design operations and CNC toolpath generation; the project is in active development.

Key features

  1. 01Run Lua code in Vectric software
  2. 02Create and edit vector paths and text
  3. 03Import and modify 3D models
  4. 04Generate CNC toolpaths
  5. 05View logs and replay command history

Use cases

  1. 01Create vector designs within Vectric
  2. 02Modify 3D models programmatically
  3. 03Generate toolpaths for CNC machining

MCP support

Its Python MCP server connects LLM clients to a Lua gadget in Vectric software over a socket, exposing commands and SDK operations.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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 is an intelligent interface for Vectric Aspire and V-Carve CAD/CAM software that enables AI-powered design and machining capabilities.

Overview

AiSpire consists of two primary components:

  1. Lua Gadget - A plugin for Vectric Aspire/V-Carve that runs inside the CAD/CAM environment
  2. Python MCP Server - A server implementing the Model Context Protocol for LLM integration
                 ┌─────────────┐            ┌─────────────┐            ┌─────────┐
                 │             │            │             │            │         │
                 │    LLMs     │◄─────────► │ Python MCP  │◄─────────► │   Lua   │
                 │             │   (MCP)    │   Server    │  (Socket)  │ Gadget  │
                 │             │            │             │            │         │
                 └─────────────┘            └─────────────┘            └─────────┘
                                                                           │
                                                                           │
                                                                           ▼
                                                                      ┌─────────────┐
                                                                      │  Vectric    │
                                                                      │ Aspire/     │
                                                                      │  V-Carve    │
                                                                      └─────────────┘

Features

  • Execute arbitrary Lua code inside Vectric software
  • Create and manipulate vector paths programmatically
  • Import and modify 3D models
  • Draw vector shapes and text
  • Optimize vector nesting for material utilization
  • Generate and calculate toolpaths for CNC machining
  • Interactive UI with log viewing and command history
  • Utilize advanced Vectric SDK capabilities:
    • Matrix transformations for precise object manipulation
    • Specialized job types (two-sided, rotary)
    • Advanced toolpath strategies (V-carving, fluting, prism carving)
    • Tool database integration
    • Custom UI elements (HTML dialogs, progress bars)
    • External toolpath generation and import/export

Project Status

AiSpire is currently in active development. Key components have been implemented:

  • Lua Socket Server: Basic socket server with command processing pipeline
  • Command Processing: Framework for executing Lua code and SDK functions
  • UI Manager: Interactive user interface with log viewer and command history
  • Helper Functions: Comprehensive library for common operations
  • Python MCP Server: Basic MCP protocol implementation with socket client

UI Features

The AiSpire Gadget includes a comprehensive user interface:

  • Log Viewer: Real-time display of system messages with color-coded severity levels
  • Command History: View and replay past commands with success/failure indicators
  • History Management: Save and load command histories for future reference
  • Connection Status: Visual indicators showing connection state and activity
  • Disconnect Controls: Safely disconnect with confirmation dialog

The UI is accessible in two ways:

  1. Primary gadget action starts the server with UI
  2. Secondary action ("Show AiSpire Control Panel") opens just the UI without restarting the server

Directory Structure

  • lua_gadget/ - Lua plugin for Vectric software
    • server.lua - Socket server implementation
    • ui_manager.lua - UI implementation for the gadget
    • json.lua - JSON parsing implementation
    • helpers/ - Helper functions for common operations
  • python_mcp_server/ - Python implementation of MCP server
  • tests/ - Test files for both components
  • docs/ - Project documentation
    • vectric_sdk/ - Contains detailed Vectric SDK reference documentation
  • llm_brain/ - AI development guidelines and project memory

Getting Started

Coming soon - Installation and usage instructions will be provided when the first functional version is available.

Building and Testing

The project includes a Makefile with various commands for building and testing:

# 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

Requirements

  • Vectric Aspire or V-Carve software
  • Lua 5.3+ with LuaSocket library
  • Python 3.8+ with required packages (see requirements.txt once available)
  • Access to an LLM supporting the Model Context Protocol

SDK Reference

The project includes a comprehensive Vectric SDK reference (located in docs/vectric_sdk/Vectric.lua) that documents the available functions for interacting with Vectric Aspire/V-Carve. This reference covers:

  • Job creation and management
  • Vector and geometry operations
  • Toolpath generation with various strategies
  • Tool database access
  • User interface elements
  • 3D component manipulation (Aspire only)
  • System information and registry access

Planned Enhancements

Based on the detailed SDK reference, we plan to implement:

  1. Advanced Geometric Operations: Matrix-based transformations, complex path creation, and polar coordinate functions
  2. Specialized Job Management: Support for two-sided and rotary jobs
  3. Comprehensive Toolpath Strategies: Profile, pocket, V-carving, fluting, prism carving, 3D roughing and finishing
  4. Tool Database Integration: Access system tool database, create custom tools
  5. UI Integration: Custom dialogs, progress bars, file selection interfaces
  6. System Integration: Application detection, file location access, registry settings
  7. External Toolpath Support: Generate, import, and export custom toolpaths

License

License information to be determined

Contact

Contact information to be provided

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.