AI导哈

Fusion 360 MCP 服务器

用于控制 Autodesk Fusion 360 的 MCP 服务器，支持 AI 助手通过参数化 CAD 建模、脚本执行和设计自动化与 Fusion 360 交互。

  • by roaming-panda-llc
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 roaming-panda-llc/roaming-panda-ad-fusion-mcp

使用说明

Fusion 360 MCP服务器

用于控制Autodesk Fusion 360的MCP（模型上下文协议）服务器。使Claude等AI助手能够与Fusion 360进行交互，以实现参数化CAD建模、脚本执行和设计自动化。

特性

  • 可流式HTTP传输：长时间运行操作（>30s）完成，无超时
  • Full Fusion 360 API访问：文档、组件、草图、实体、参数
  • 脚本执行：在Fusion 360上下文中运行任意Python代码
  • 电脑屏幕截图工具：获取视口图像以获得视觉反馈
  • 版本管理：列出并还原文档版本

安装

快速入门（推荐）

# Run directly without installing
uvx roaming-panda-ad-fusion-mcp serve

从PyPI安装

pip install roaming-panda-ad-fusion-mcp
roaming-panda-ad-fusion-mcp serve

从源代码安装

git clone https://github.com/roaming-panda-llc/roaming-panda-ad-fusion-mcp.git
cd roaming-panda-ad-fusion-mcp
pip install -e .

Fusion 360附加模块设置

MCP服务器通过必须安装的REST API插件与Fusion 360通信：

  1. 复制 addin/ 文件夹到Fusion 360加载项目录：

    • macOS: ~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/
    • 视窗: %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\

  2. 在Fusion 360中，转到 工具>加载项 并启用“FusionMCP”

  3. 验证加载项是否正在运行：

    roaming-panda-ad-fusion-mcp health

用法

启动MCP服务器

# Default: http://127.0.0.1:8765/mcp
roaming-panda-ad-fusion-mcp serve

# Custom port
roaming-panda-ad-fusion-mcp serve --port 9000

配置Claude代码

添加到 ~/.claude.json:

{
  "mcpServers": {
    "fusion360": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

可用工具

工具 说明
fusion360_health 检查Fusion 360加载项是否正在运行
fusion360_document_info 获取当前文档信息
fusion360_components 获取组件树
fusion360_sketches 列出所有草图
fusion360_sketch_details 按名称获取草图详细信息
fusion360_bodies 列出所有尸体
fusion360_body_details 按姓名获取身体详细信息
fusion360_parameters 获取用户参数
fusion360_screenshot 捕获视口图像
fusion360_run_script 在Fusion 360中执行Python代码
fusion360_create_sketch 创建新草图
fusion360_draw_circle 在草图中画一个圆
fusion360_draw_rectangle 在草图中绘制一个矩形
fusion360_extrude 拉伸草图轮廓
fusion360_activate_component 激活组件
fusion360_set_visibility 显示/隐藏组件
fusion360_list_versions 列出文档版本
fusion360_restore_version 还原文档版本

发展

设置

git clone https://github.com/roaming-panda-llc/roaming-panda-ad-fusion-mcp.git
cd roaming-panda-ad-fusion-mcp
uv sync --all-extras

运行测试

uv run pytest --cov --cov-report=term-missing

运行突变测试

uv run mutmut run
uv run mutmut results

棉绒

uv run ruff check src/ tests/
uv run ruff format src/ tests/

建筑

┌─────────────┐     HTTP POST     ┌──────────────┐     REST API     ┌─────────────┐
│ Claude Code │ ───────────────▶ │  MCP Server  │ ───────────────▶ │  Fusion 360 │
│             │                   │  (Starlette) │                   │   Add-in    │
│             │ ◀─────────────── │              │ ◀─────────────── │             │
└─────────────┘    SSE events    └──────────────┘    JSON response  └─────────────┘

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP