mcp-freecad

# FreeCAD Addon Rename and Extension Summary ## Renaming from MCP Integration to FreeCAD AI ### 1. File Renaming - **Main workbench file**: `freecad_mcp_workbench.py` → `freecad_ai_workbench.py` ### 2. Metadata Updates - **package.xml**: Updated name to "FreeCAD AI" and description - **metadata.txt**: Updated name to "FreeCAD AI" and description - **__init__.py**: Updated ADDON_NAME to "FreeCAD AI" - **InitGui.py**: Updated all references and title to "FreeCAD AI" ### 3. UI Text Updates - All "MCP Integration" references changed to "FreeCAD AI" throughout: - Console messages - Window titles - Tab names - Status messages - Dialog titles ### 4. Script Updates - **sync_addon.py**: Updated workbench selection message - **Various files**: Updated all references to use the new naming ## Extension with MCP FreeCAD Components ### 1. Advanced Tools Added From `src/mcp_freecad/tools/`: - **assembly.py**: Assembly management tools (create assembly, add parts, constraints) - **cam.py**: CAM operations (create jobs, tools, operations, G-code generation) - **rendering.py**: Rendering capabilities (scene setup, camera, lighting, materials) - **smithery.py**: Fun smithery tools (anvil, hammer, tongs, blade forging) Location: `freecad-ai/tools/advanced/` ### 2. Resources Added From `src/mcp_freecad/resources/`: - **material.py**: Material management system - **constraint.py**: Constraint system - **measurement.py**: Advanced measurement resources - **cad_model.py**: CAD model management Location: `freecad-ai/resources/` ### 3. Events Added From `src/mcp_freecad/events/`: - **document_events.py**: Document change events - **command_events.py**: Command execution events - **error_events.py**: Error handling events Location: `freecad-ai/events/` ### 4. API Added From `src/mcp_freecad/api/`: - **events.py**: Event management API - **tools.py**: Tool management API - **resources.py**: Resource management API Location: `freecad-ai/api/` ### 5. Clients Added From `src/mcp_freecad/clients/`: - **freecad_client.py**: FreeCAD client capabilities - **cursor_mcp_bridge.py**: Cursor MCP bridge Location: `freecad-ai/clients/` ## New Features in the Addon ### 1. Advanced Tools Tab A new tab in the UI that provides access to: - **Assembly Tools**: Create and manage assemblies - **CAM Tools**: Computer-aided manufacturing operations - **Rendering Tools**: Scene setup and rendering - **Smithery Tools**: Fun blacksmithing-themed modeling tools ### 2. Resources Tab A new tab providing access to: - **Material Resources**: List materials, view library, apply materials - **Constraint Resources**: (Coming soon) Constraint management - **Measurement Resources**: (Coming soon) Advanced measurements ### 3. Enhanced Architecture - Modular import system with fallback handling - Asynchronous tool execution - Resource providers for materials and constraints - Event handling system for document and command events - API layer for tool and resource management ## Benefits of the Extension 1. **More Comprehensive Toolset**: The addon now includes advanced manufacturing, assembly, and rendering tools 2. **Better Resource Management**: Materials and constraints can be managed through dedicated providers 3. **Event-Driven Architecture**: Document and command events can be tracked and responded to 4. **API Layer**: Standardized API for tools and resources 5. **Future-Ready**: The modular architecture allows for easy addition of new tools and features ## Usage The addon maintains its focus on AI-powered CAD assistance while expanding its capabilities with: - Direct AI integration (Claude, Gemini, OpenRouter) - MCP server support for Claude Desktop - Extended tool palette for advanced operations - Resource management for materials and constraints - Event handling for responsive automation The renaming to "FreeCAD AI" better reflects the addon's primary focus on AI-powered assistance, while the MCP (Model Context Protocol) remains as the underlying technology for external integrations.