Fusion360 MCP Server

🚀 融合360 MCP服务器

本项目是一个中间件，用于连接Cline与Autodesk Fusion 360。它借助API将Fusion 360的工具栏命令转化为可调用工具，通过自然语言解析实现具体操作，如“创建一个带圆角的盒子”。项目会生成可在Fusion 360中直接运行的Python脚本。

🚀 快速开始

本项目是连接Cline与Autodesk Fusion 360的中间件，借助API将Fusion 360工具栏命令转化为可调用工具，通过自然语言解析实现具体操作，还能生成可在Fusion 360中运行的Python脚本。

✨ 主要特性

• 通过API将Fusion 360的工具栏命令暴露为可调用工具。
• 支持自然语言解析，将自然语言转化为具体的操作步骤。
• 生成可在Fusion 360中直接运行的Python脚本。

📦 安装指南

系统要求

• Python 3.9或更高版本
• Autodesk Fusion 360

安装步骤

1. 克隆此仓库到本地。
2. 使用以下命令安装依赖：

pip install -r requirements.txt

💻 使用示例

基础用法

HTTP模式

python server.py --http

访问http://localhost:5000使用REST API。

MCP模式（Fusion插件）

将server.py作为Fusion插件运行，通过标准输入输出与插件通信。

高级用法

以下是脚本生成的示例代码，展示了如何在Fusion 360中创建一个简单的拉伸体：

import adsk.core, adsk.fusion, traceback

def run(context):
    ui = None
    try:
        app = adsk.core.Application.get()
        ui = app.userInterface
        design = app.activeProduct
        
        # 获取当前组件
        component = design.rootComponent
        
        # 创建XY平面新草图
        sketch = component.sketches.add(component.xYConstructionPlane)
        
        # 绘制矩形
        rectangle = sketch.sketchCurves.sketchLines.addTwoPointRectangle(
            adsk.core.Point3D.create(0, 0, 0),
            adsk.core.Point3D.create(10, 10, 0)
        )
        
        # 拉伸操作
        prof = sketch.profiles.item(0)
        extrude_input = component.features.extrudeFeatures.createInput(prof, adsk.fusion.FeatureOperations.NewBodyFeatureOperation)
        distance_input = adsk.core.ValueInput.createByReal(5)
        extrude_input.setDistanceExtent(False, distance_input)
        extrude = component.features.extrudeFeatures.add(extrude_input)
        
        ui.messageBox('操作完成')
    except:
        if ui:
            ui.messageBox(f'失败:\n{traceback.format_exc()}')

📚 详细文档

项目结构

• tool_registry.json: 定义可用工具及其参数。
• script_generator.py: 根据工具调用生成Python脚本。
• 其他文件：日志、模板等辅助文件。

工具扩展

添加新工具步骤

1. 在tool_registry.json中添加新工具的定义，包括名称和参数。
2. 更新script_generator.py中的SCRIPT_TEMPLATES以支持新工具。
3. 实现新的参数处理逻辑在_process_parameters函数中。

未来增强

• 实现会话状态跟踪，支持上下文感知操作。
• 推动动态工具注册功能。
• 开发自动化机制，通过套接字或文件轮询实现。
• 扩展更多Fusion命令。

📄 许可证

项目遵循MIT许可证，详细信息见LICENSE文件。