自然语言CAD建模服务

Plugin Mode Architecture (Recommended for Production)
┌─────────────────┐    TCP Socket   ┌─────────────────┐    MCP         ┌─────────────────┐
│   Fusion 360    │◄────:8765──────►│   MCP Server    │◄──────────────►│   AI Client     │
│   + Plugin      │                 │   (FastMCP)     │                │ (Cursor/Claude) │
│  (Real API)     │                 │                 │                │                 │
└─────────────────┘                 └─────────────────┘                └─────────────────┘
        ↑                                    ↑                                  ↑
        │                                    │                                  │
    Fusion API                      Socket Bridge                         MCP Protocol
                                    + Tool Modules                     (JSON-RPC 2.0)

Simulation Mode Architecture (Development & Testing)
┌─────────────────┐    MCP         ┌─────────────────┐
│   MCP Server    │◄──────────────►│   AI Client     │
│  (Mock Data)    │                │ (Cursor/Claude) │
│                 │                │                 │
└─────────────────┘                └─────────────────┘

AI Command → MCP Client → stdio → MCP Server → TCP Socket → Fusion360 Plugin → Fusion360 API → CAD Operation

# Clone the repository
git clone https://github.com/zkbkb/fusion-mcp.git
cd fusion-mcp

# Install Python dependencies
pip install -r requirements.txt

# Run plugin installation script
python install_addin.py

Using fixed manifest file
Fusion360 plugin installed to: /Users/.../Autodesk/Fusion 360/API/AddIns/FusionMCP
Plugin features:
   - Fixed shebang issue
   - Improved global variable initialization
   - Simplified error handling
   - runOnStartup: false (manual start)
   - Full feature set included

{
  "mcpServers": {
    "fusion360": {
      "command": "python",
      "args": ["<PROJECT_PATH>/src/mcp_server.py"],
      "env": {
        "PYTHONPATH": "<PROJECT_PATH>/src"
      }
    }
  }
}

# Run complete system test
python tests/integration/test_fusion360_integration.py

Starting Fusion360 MCP complete system test
Socket connection successful
Sketch created successfully
Circle drawn successfully
Rectangle drawn successfully
Test complete! You can now view the created geometry in Fusion 360

# Custom Socket port (default: 8765)
export FUSION_MCP_PORT=8765

# Custom Socket host (default: localhost)
export FUSION_MCP_HOST=localhost

# Enable debug logging
export MCP_DEBUG=true

{
    "autodeskProduct": "Fusion360",
    "type": "addin",
    "id": "com.autodesk.FusionMCP",
    "version": "1.1.0",
    "runOnStartup": false,
    "supportedOS": ["windows", "mac"]
}

# Install development dependencies
pip install -r requirements.txt

# Install development tools
pip install black flake8 mypy pytest pytest-cov

fusion-mcp/
├── src/                          # Source code directory
│   ├── mcp_server.py            # MCP server main entry (FastMCP)
│   ├── tools/                   # Modular tool implementations
│   │   ├── sketch/              # Sketch tool modules
│   │   │   ├── basic.py        # Basic drawing tools
│   │   │   ├── advanced.py     # Advanced drawing tools
│   │   │   └── constraints.py  # Constraint tools
│   │   ├── modeling/            # Modeling tool modules
│   │   │   ├── features.py     # Feature tools
│   │   │   ├── patterns.py     # Pattern tools
│   │   │   └── advanced.py     # Advanced modeling tools
│   │   ├── assembly/            # Assembly tool modules
│   │   │   ├── components.py   # Component management
│   │   │   ├── constraints.py  # Assembly constraints
│   │   │   └── motion.py       # Motion studies
│   │   ├── analysis/            # Analysis tool modules
│   │   │   ├── measurement.py  # Measurement tools
│   │   │   ├── simulation.py   # Simulation analysis
│   │   │   └── reporting.py    # Report generation
│   │   └── utils.py            # Shared utility functions
│   ├── core/                    # Core components
│   │   ├── bridge.py           # API communication bridge layer
│   │   ├── config.py           # Configuration management
│   │   └── resources.py        # Resource management
│   ├── context/                 # Context management
│   │   ├── persistence.py      # Design intent persistence
│   │   └── tools.py            # Context tools
│   ├── fusion360/               # Fusion360 plugin source code
│   │   ├── addin.py            # Plugin main file
│   │   └── FusionMCP.manifest  # Plugin manifest
│   └── utils/                   # Utility functions
│       ├── error_handler.py    # Error handling
│       ├── helpers.py          # Helper functions
│       ├── logging_config.py   # Logging configuration
│       └── validators.py       # Parameter validation
├── tests/                       # Test suite
│   ├── unit/                   # Unit tests
│   ├── integration/            # Integration tests
│   ├── performance/            # Performance tests
│   ├── platform/               # Platform compatibility tests
│   └── fixtures/               # Test fixtures
├── install_addin.py            # Plugin installation script
├── mcp_config.json             # MCP client configuration example
├── requirements.txt            # Python dependencies
├── setup.py                    # Package installation configuration
├── LICENSE                     # License file
└── README.md                   # This file

# src/tools/sketch/basic.py

async def draw_ellipse(
    center_x: float,
    center_y: float,
    major_radius: float,
    minor_radius: float,
    sketch_name: Optional[str] = None
) -> Dict[str, Any]:
    """
    Draw an ellipse in a sketch

    Args:
        center_x: Ellipse center X coordinate
        center_y: Ellipse center Y coordinate
        major_radius: Major axis radius
        minor_radius: Minor axis radius
        sketch_name: Target sketch name

    Returns:
        Dictionary containing operation result
    """
    # Implement ellipse drawing logic
    pass

# src/tools/sketch/__init__.py

from .basic import (
    draw_line,
    draw_circle,
    draw_rectangle,
    draw_ellipse,  # New addition
)

# src/mcp_server.py

@mcp.tool()
async def draw_ellipse(
    center_x: float,
    center_y: float,
    major_radius: float,
    minor_radius: float,
    sketch_name: Optional[str] = None
) -> str:
    """Draw an ellipse in a sketch"""
    parameters = {
        "center_x": center_x,
        "center_y": center_y,
        "major_radius": major_radius,
        "minor_radius": minor_radius,
        "sketch_name": sketch_name
    }

    try:
        result = fusion_bridge.send_command("draw_ellipse", parameters)
        _log_tool_execution("draw_ellipse", parameters, result)
        return json.dumps(result, ensure_ascii=False)
    except Exception as e:
        result = {"error": str(e)}
        _log_tool_execution("draw_ellipse", parameters, result)
        return json.dumps(result, ensure_ascii=False)

# tests/unit/test_sketch_tools.py

@pytest.mark.asyncio
async def test_draw_ellipse():
    """Test ellipse drawing functionality"""
    result = await draw_ellipse(
        center_x=0,
        center_y=0,
        major_radius=10,
        minor_radius=5,
        sketch_name="TestSketch"
    )
    assert "error" not in result
    assert result["success"] == True

python install_addin.py

# Code formatting
black src/ tests/

# Code linting
flake8 src/ tests/

# Type checking
mypy src/

# Import sorting
isort src/ tests/

{
  "python.linting.enabled": true,
  "python.linting.flake8Enabled": true,
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "python.analysis.typeCheckingMode": "basic"
}

# Run all tests
pytest

# Run unit tests
pytest tests/unit/

# Run integration tests (requires Fusion360 plugin running)
pytest tests/integration/

# Run specific test file
pytest tests/unit/test_sketch_tools.py

# Run coverage tests
pytest --cov=src --cov-report=html

# Run performance tests
pytest tests/performance/

Connection to Fusion 360 plugin failed: [Errno 61] Connection refused
Tool module initialization failed, using built-in implementation

{
  "error": "No active design found",
  "success": false
}

# Test MCP server
python -m src.mcp_server

# Test Socket connection
python test_mcp_connection.py

# Run platform compatibility tests
pytest tests/platform/test_compatibility.py -v

# Run complete system test
python tests/integration/test_fusion360_integration.py

<type>(<scope>): <description>

[optional body]

[optional footer]

feat(modeling): add boolean union operation
fix(sketch): resolve constraint calculation error
docs(readme): update installation instructions