FusionMCP 是一个全面的模型上下文协议（MCP）集成层，连接 Autodesk Fusion 360 与多个 AI 后端（Ollama、OpenAI、Google Gemini 和 Anthropic Claude），通过自然语言实现基于 AI 的参数化 CAD 设计。

🎯 特色

• 🤖 多模型支持：可无缝切换Ollama、OpenAI GPT-4o、Google Gemini和Claude 3.5
• 🔄 智能路由：主模型故障时自动备份链
• 📐 参数化设计：AI理解并生成参数化CAD操作
• 🛡️ 安全第一：内置尺寸、单位和几何可行性的验证功能
• 💾 上下文缓存：对话与设计状态持久化（JSON/SQLite）
• 🎨 Fusion 360集成：实现无缝工作流程的原生插件
• ⚡ 异步架构：快速、非阻塞操作，带重试逻辑
• 📊 结构化日志：使用Loguru的详细日志

📋 目录

• 建筑学
• 安装
• 快速入门
• 配置
• 使用示例
• API 参考
• 模型比较
• 发展
• 故障排除
• 贡献

🏗️ 建筑

组件概述

Fusion 360 MCP - Multi-Model AI Integration

FusionMCP is a comprehensive Model Context Protocol (MCP) integration layer that connects Autodesk Fusion 360 with multiple AI backends (Ollama, OpenAI, Google Gemini, and Anthropic Claude) to enable AI-powered parametric CAD design through natural language.

🎯 Features

• 🤖 Multi-Model Support: Seamlessly switch between Ollama, OpenAI GPT-4o, Google Gemini, and Claude 3.5
• 🔄 Intelligent Routing: Automatic fallback chain when primary model fails
• 📐 Parametric Design: AI understands and generates parametric CAD operations
• 🛡️ Safety First: Built-in validation for dimensions, units, and geometric feasibility
• 💾 Context Caching: Conversation and design state persistence (JSON/SQLite)
• 🎨 Fusion 360 Integration: Native add-in for seamless workflow
• ⚡ Async Architecture: Fast, non-blocking operations with retry logic
• 📊 Structured Logging: Detailed logs with Loguru

📋 Table of Contents

• Architecture
• Installation
• Quick Start
• Configuration
• Usage Examples
• API Reference
• Model Comparison
• Development
• Troubleshooting
• Contributing

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Fusion 360 User                         │
│                           ↓                                 │
│              ┌─────────────────────────┐                    │
│              │  Fusion 360 Add-in      │                    │
│              │  - UI Dialog            │                    │
│              │  - Action Executor      │                    │
│              │  - Network Client       │                    │
│              └──────────┬──────────────┘                    │
│                         ↓ HTTP/REST                         │
│              ┌─────────────────────────┐                    │
│              │   MCP Server (FastAPI)  │                    │
│              │  - Router               │                    │
│              │  - Schema Validation    │                    │
│              │  - Context Cache        │                    │
│              └──────────┬──────────────┘                    │
│                         ↓                                    │
│         ┌───────────────┴───────────────────┐               │
│         ↓               ↓           ↓       ↓               │
│   ┌─────────┐   ┌──────────┐  ┌────────┐  ┌──────────┐     │
│   │ Ollama  │   │  OpenAI  │  │ Gemini │  │  Claude  │     │