使用说明
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 socket
Fusion 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
