F360 MCP 服务器
Autodesk Fusion 360的MCP服务器——文件管理、导出、导入, 以及设计查询。
概述
这是一个 模型上下文协议(MCP) 连接AI助手(Claude Code、Cursor等)的服务器 Autodesk Fusion 360。它通过以下方式实现了人工智能驱动的3D CAD操作 干净的模块化工具界面。
建筑
AI Assistant (stdio) --> F360 MCP Server (TCP:9876) --> F360 Add-in --> Fusion 360 API两个组成部分:
- MCP服务器 (
berrevoets-f360-mcp)——使用FastMCP的Python包,
通过stdio与Claude Code通信
- Fusion 360插件 (
addon/)--内部运行的Python脚本
Fusion 360,通过TCP套接字公开API
安装
MCP服务器
uv tool install berrevoets-f360-mcp或者直接运行:
uvx berrevoets-f360-mcp --mode socketFusion 360插件
python scripts/install_addon.py然后在Fusion 360的实用程序>插件下启用“F360MCP”。
Claude代码配置
添加到您的Claude Code MCP设置中:
{
"mcpServers": {
"fusion360": {
"command": "uvx",
"args": ["berrevoets-f360-mcp", "--mode", "socket"]
}
}
}可用工具
对场景查询
| 工具 | 说明 |
|---|---|
get_scene_info | 设计概述(车身、草图、计数) |
get_object_info | 详细的车身/草图信息+边界框 |
list_components | 平面组件列表 |
出口
| 工具 | 说明 |
|---|---|
export_stl | 将单体导出为STL |
export_step | 将整个设计导出为STEP |
export_f3d | 导出为Fusion 360存档 |
导入
| 工具 | 说明 |
|---|---|
import_step | 将STEP文件导入当前设计 |
import_f3d | 导入Fusion 360存档 |
分析
| 工具 | 说明 |
|---|---|
measure_distance | 实体之间的最小距离 |
measure_angle | 两个物体之间的角度 |
get_physical_properties | 质量、体积、面积、密度 |
参数
| 工具 | 说明 |
|---|---|
get_parameters | 列出用户参数 |
create_parameter | 创建新参数 |
set_parameter | 更新参数值 |
delete_parameter | 删除参数 |
效用
| 工具 | 说明 |
|---|---|
ping | 健康检查 |
execute_code | 在Fusion 360中运行任意Python |
undo | 撤消上次操作 |
delete_all | 清除所有功能 |
MCP资源
| 资源URI | 描述 |
|---|---|
fusion360://status | Fusion 360的连接状态 |
fusion360://design | 当前设计树(JSON) |
fusion360://parameters | 用户参数(JSON) |
发展
先决条件
- Python 3.11+
- 紫外线 包管理器
- Autodesk Fusion 360(适用于插座模式;模拟模式不需要)
设置
uv sync --dev测试
测试在模拟模式下运行——不需要Fusion 360:
# Run all tests
pytest tests/
# Run a single test
pytest tests/test_tools.py::test_ping过梁和类型检查
ruff check src/ tests/
mypy src/项目结构
src/berrevoets_f360_mcp/ # MCP server (FastMCP + tools)
addon/ # Fusion 360 add-in (socket bridge)
scripts/ # Install/uninstall helpers
tests/ # Mock-mode tests许可证
麻省理工学院许可证 - 版权所有 (c) 2026 Bert Berrevoets / Berrevoets Systems
