mcp-freecad

# Changelog - MCP Integration FreeCAD Addon All notable changes to this addon will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.0.1] - 2025-11-06 ### Fixed - **AI Model Names**: Updated all Claude model references to use valid Anthropic API names - Changed `claude-sonnet-4` → `claude-3-5-sonnet-20241022` (default) - Changed `claude-opus-4` → `claude-3-opus-20240229` - Changed `claude-haiku-3.5` → `claude-3-5-haiku-20241022` - Removed future-dated `claude-4-*` models that don't exist - Removed non-existent `claude-3-7-sonnet` model - **Exception Handling**: Replaced 34 bare `except:` clauses with `except Exception:` for better error tracking - **Code Quality**: Improved exception handling patterns throughout codebase - Fixed 2 JSON parsing errors to use specific `except json.JSONDecodeError:` - Modified 13 files for better error handling - **Module Structure**: Cleaned up `utils/__init__.py` - Removed unnecessary try/except block with only `pass` - Removed duplicate `__all__` declarations - Simplified imports to be direct and clear - **Performance**: Optimized dictionary iteration patterns - **Logging**: Added logging to OpenRouter provider for better debugging ### Changed - **Version**: Updated `InitGui.py` version from `0.7.11` → `1.0.0` for consistency - **Configuration**: Updated `addon_config.json` with correct model names and accurate token limits - **Thinking Mode**: Disabled thinking mode in config (not available in public Claude API) ### Technical - All 111 Python files validated for syntax correctness - All modified files compile successfully - Exception handling now follows Python best practices - No bare except clauses remaining (34 → 0) ## [1.0.0] - 2025-01-27 ### Added - **Complete FreeCAD workbench** with fully functional tabbed interface - **Claude 4 + Thinking Mode integration** - Advanced AI reasoning capabilities - **Complete tool implementations**: - Primitives tool (box, cylinder, sphere, cone, torus) - Operations tool (boolean union, cut, intersection, move, rotate, scale) - Measurements tool (distance, angle, volume, area, bounding box, edge length) - Export/Import tool (STL, STEP, IGES, BREP formats) - **Professional GUI interface** with 5 comprehensive tabs: - AI Models tab with provider selection and API management - Connections tab for MCP server connections - Servers tab for server monitoring and control - Tools tab for executing MCP tools - Logs tab for activity monitoring - **Multi-provider AI support**: - Claude (Anthropic) with Claude 4 models - Gemini (Google) ready for integration - OpenRouter with 13+ model support - **Real-time features**: - Live connection status monitoring - Chat interface with AI providers - Activity logging and diagnostics - Error handling with user feedback ### Features - Support for multiple MCP connection methods (launcher, wrapper, server, bridge, mock) - Complete boolean operations for 3D modeling - Comprehensive measurement tools for CAD analysis - Multi-format export/import capabilities - Secure API key management - Persistent configuration storage - Robust error handling and recovery - Professional branding and metadata ### Technical Details - Compatible with FreeCAD 0.20.0+ - Python 3.8+ requirement - PySide2 GUI framework - Full MCP protocol implementation - Asynchronous AI API communication - Thread-safe operation - Comprehensive logging system ### Fixed - All runtime errors resolved - Widget initialization order corrected - Workbench registration issues fixed - Command system properly implemented - Version consistency across all files ### Known Limitations - Code generator tool pending implementation - Advanced AI features (token monitoring) planned for v1.1 - Some UI polish items deferred to future releases ## [Unreleased] ### Planned - Complete implementation of all GUI components - Enhanced AI conversation interface - Custom tool creation wizard - Performance optimization - Multi-language support - Advanced diagnostic tools