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通信：
- 复制
addin/文件夹到Fusion 360加载项目录：
- macOS: ~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/ - 视窗: %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\
- 在Fusion 360中，转到 工具>加载项 并启用“FusionMCP”
- 验证加载项是否正在运行：
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许可证-有关详细信息，请参阅许可证文件。