Fusion 360 MCP Server

Fusion 360 MCP Server

site icon
2025.04.11 5
Python自动化设计教育工具开发工具开发效率
Fusion 360 MCP Server 是一个模型上下文协议(MCP)服务器,用于在Cline和Autodesk Fusion 360之间建立接口。该服务器将Fusion 360的工具栏级命令暴露为可调用的工具,这些工具直接映射到Fusion的API。它能够解析自然语言提示,将其解析为Fusion工具操作,并通过MCP服务器调用这些工具,最终生成可在Fusion 360中执行的Python脚本。
View on GitHub

Overview

基本能力

产品定位

Fusion 360 MCP Server 是一个用于连接Cline和Autodesk Fusion 360的中间件,旨在通过自然语言解析和API调用简化Fusion 360的操作流程。

核心功能

  1. 自然语言解析:将自然语言提示(如“制作一个带圆角的盒子”)解析为具体的Fusion工具操作序列。
  2. 工具调用:通过MCP服务器调用Fusion 360的API工具,如创建草图、绘制矩形、拉伸等。
  3. 脚本生成:生成可在Fusion 360中执行的Python脚本。
  4. 多工具调用:支持按顺序调用多个工具并生成复合脚本。

适用场景

  1. 自动化设计:通过自然语言快速生成复杂的设计脚本。
  2. 教育:帮助初学者通过自然语言学习Fusion 360的操作。
  3. 开发:为开发者提供快速生成Fusion 360脚本的工具。

工具列表

  1. CreateSketch:在指定平面上创建新草图。
  2. DrawRectangle:在活动草图中绘制矩形。
  3. DrawCircle:在活动草图中绘制圆形。
  4. Extrude:将轮廓拉伸为3D实体。
  5. Revolve:将轮廓绕轴旋转。
  6. Fillet:为选定的边添加圆角。
  7. Chamfer:为选定的边添加倒角。
  8. Shell:以指定壁厚挖空实体。
  9. Combine:使用布尔操作组合两个实体。
  10. ExportBody:将实体导出到文件。

常见问题解答

  1. 如何添加新工具?
  2. src/tool_registry.json中添加新工具定义。
  3. src/script_generator.py中添加脚本模板和参数处理逻辑。

  4. 如何调试生成的脚本?

  5. 在Fusion 360的脚本编辑器中执行生成的脚本,查看错误信息。

使用教程

使用依赖

  1. Python 3.9或更高版本 bash python --version
  2. Autodesk Fusion 360

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/fusion360-mcp-server.git cd fusion360-mcp-server
  2. 安装依赖: bash pip install -r requirements.txt

调试方式

  1. 启动HTTP服务器: bash cd src python main.py
  2. 启动MCP服务器: bash cd src python main.py --mcp
  3. 测试API端点:
  4. 列出所有工具: bash curl -X GET http://127.0.0.1:8000/tools
  5. 调用单个工具: bash curl -X POST http://127.0.0.1:8000/call_tool \ -H "Content-Type: application/json" \ -d '{ "tool_name": "CreateSketch", "parameters": { "plane": "xy" } }'
  6. 调用多个工具: bash curl -X POST http://127.0.0.1:8000/call_tools \ -H "Content-Type: application/json" \ -d '{ "tool_calls": [ { "tool_name": "CreateSketch", "parameters": { "plane": "xy" } }, { "tool_name": "DrawRectangle", "parameters": { "width": 10, "depth": 10 } }, { "tool_name": "Extrude", "parameters": { "height": 5 } } ] }'

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。