内容
# Fusion 360 桥接
**赋予 AI 代理完整的 Fusion 360 Python API。**
Fusion 360 桥接是 Fusion 360 和任何支持 MCP（消息传递能力）的代理之间的一个小型开放桥接。它可以检查设计，创建或修改几何体，查找已安装的 Fusion API，并返回视口截图 — 所有这些都通过四个工具。
> Fusion 保持控制：每个 API 调用都在 Fusion 的主线程上运行，桥接仅在 `127.0.0.1` 上监听，并带有 bearer-token 身份验证。
## 它能做什么
要求您的代理：
- **构建几何体** — 草图、约束、特征、实体、组件和组件集
- **检查和编辑设计** — 参数、材料、外观、时间线和文档状态
- **使用制造 API** — 在可用时访问已安装的 `adsk.cam` API
- **发现 API** — 搜索确切的类和成员，无需离开对话
- **查看结果** — 捕获活动视口的当前大小或请求的分辨率
没有预先构建的 CAD 操作库。`fusion_execute_python` 公开真正的 Fusion Python API，因此代理可以使用该 API 支持的任何功能。
## 从数据表到 Fusion 模型
这个 [Pololu 微型金属齿轮电机](https://www.pololu.com/product/2202) 起始于一个空白的 Fusion 文档。桥接重建了其发布的外部尺寸，分配了黄铜、钢、塑料和铜的材质，并构建了一个七组件的组件集。其四级齿轮箱使用 Pololu 公布的齿数，实现了精确的 29.86:1 的比例。
| 齿轮箱细节 | 纵向截面分析 |
| --- | --- |
|  |  |
外部尺寸来自 Pololu 的 [2024 年 4 月图纸](https://www.pololu.com/file/0J949/micro-metal-gearmotor-dimensions.pdf)。运行时验证检查关键测量值、级间距、实体干涉、壳体间隙和保存的截面分析。内部模块和轴坐标是记录的重建，因为公开的图纸没有标注它们。
[阅读完整的示例](examples/pololu-gearmotor/README.md)，包括建模决策、图像库、验证范围、来源和可复制的 Fusion 脚本。
## 快速入门
### 1. 添加 MCP 服务器
如有需要，请安装 [`uv`](https://docs.astral.sh/uv/)，然后将以下内容添加到您的 MCP 客户端配置中：
```json
{
"mcpServers": {
"fusion360": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/barisgit/fusion360-bridge@v0.3.1",
"fusion360-bridge",
"serve"
]
}
}
}
```
固定一个发布标签可保持安装的可复制性。
### 2. 启动 Fusion 360
第一次 MCP 启动会安装捆绑的 **FusionBridge** 加载项。重启 Fusion 360，或打开 **实用工具 → 加载项**（`Shift+S`），然后运行 **FusionBridge**。
### 3. 检查连接
要求您的代理：
> 检查 Fusion 连接，然后告诉我活动文档的名称。
或从终端检查：
```bash
uvx --from git+https://github.com/barisgit/fusion360-bridge@v0.3.1 \
fusion360-bridge health
```
## 四个工具，完整的 API 访问
| 工具 | 目的 |
| --- | --- |
| `fusion_health` | 返回 Fusion 版本和活动文档 |
| `fusion_execute_python` | 运行带有 `adsk`、`app` 和 `ui` 预加载的 Python |
| `fusion_api_docs` | 搜索已安装的 `adsk.core`、`adsk.fusion` 和 `adsk.cam` 类 |
| `fusion_screenshot` | 返回活动视口的 PNG 图片 |
MCP 服务器还将捆绑的 [`fusion360-cad` 技能](.agents/skills/fusion360-cad/SKILL.md) 公开为标准资源。实现 MCP 技能扩展的客户端可以通过 `skill://index.json` 发现它；其他客户端可以直接读取 `skill://fusion360-cad/SKILL.md`。
```text
MCP 客户端 ──stdio──> MCP 服务器 ──身份验证的本地 HTTP──> Fusion 加载项
│
Fusion 主线程
```
stdio 服务器只是一个适配器。脚本也可以直接调用本地 HTTP API。
## 试用
连接后，提示可以像这样直接：
> 创建一个 60 × 40 × 20 毫米的外壳，带有 3 毫米的墙壁，对外部边缘进行圆角处理，并给我一个等轴测截图。
> 检查活动设计并列出每个组件、实体、材料和用户参数。
> 查找 `ExtrudeFeatures.createInput` 的已安装 API，然后使用它向选定的配置文件添加 12 毫米的拉伸。
代理编写并执行普通的 Fusion Python，然后可以检查结果并迭代。
## 文档
- [入门](docs/getting-started.md) — 安装、配置、更新、故障排除
- [工具和 HTTP 参考](docs/reference.md) — MCP 工具、端点、示例、安全
- [开发](docs/development.md) — 本地设置、架构、检查、发布
- [示例](examples/README.md) — 通过桥接构建的源接地模型
- [Fusion 360 CAD 技能](.agents/skills/fusion360-cad/SKILL.md) — 代理的有纪律的检查、建模、验证和证据工作流
## 重要的安全注意事项
`fusion_execute_python` 有意在 Fusion 360 内运行任意 Python 代码。只有连接可信的 MCP 客户端和代理。保持服务器绑定到 `127.0.0.1`，启用身份验证，并且永远不要将端口 `7654` 暴露给网络。
## 要求
- macOS 或 Windows 上的 Autodesk Fusion 360
- 支持 MCP 的客户端，或可以调用本地 HTTP 的任何程序
- 用于一键式 MCP 设置的 [`uv`](https://docs.astral.sh/uv/)
Fusion 360 必须打开并运行 FusionBridge 加载项；Fusion 没有支持的无头模式。
