JinDaGe - fusion-360-mcp-server MCP Details

article

README

🚀 融合 360 MCP 服务器

本项目仓库包含一个专门针对 Autodesk Fusion 360 的 Model Context Protocol (MCP) 服务器。借助该服务器，AI 助手（例如 Claude）能够直接通过 MCP 协议与 Fusion 360 进行交互，为 CAD 设计工作带来更智能、高效的体验。

🚀 快速开始

本服务器作为 Fusion 360 的加成组件，将 Fusion 360 的功能通过 MCP 协议开放给外部系统。AI 代理可借此访问设计信息、创建和修改设计元素，还能获取 CAD 任务相关的特定提示。

✨ 主要特性

信息访问：AI 代理可获取当前设计的基本信息、组件、参数等。
操作执行：能够执行创建草图、添加参数、显示消息等操作。
提示获取：接收专门用于 CAD 相关任务的提示模板。

📦 安装指南

先决条件

安装 Autodesk Fusion 360。
准备 Python 3.7+ 环境（用于安装和测试）。
在 Fusion 360 的 Python 环境中安装 MCP Python SDK：pip install "mcp[cli]"。

安装步骤

1. 在 Fusion 360 的 Python 环境中安装 MCP

Fusion 360 有独立的 Python 环境，MCP 包需在此环境中安装。

使用安装程序脚本（推荐）：

python install_mcp_for_fusion.py

此脚本会自动查找计算机上所有 Fusion 360 的 Python 安装位置，为每个位置安装带有 CLI 插件的 MCP 包，并验证安装是否成功。

手动安装：
- 找到 Fusion 360 的 Python 可执行文件（通常位于 Autodesk\webdeploy\production\[版本]\Python）。
- 执行以下命令安装包：

"[Fusion Python Path]\python.exe" -m pip install "mcp[cli]"

2. 安装 Fusion 360 加成组件

在 Fusion 360 中，点击菜单栏的“加成”选项。
选择“从文件加载”。
浏览到 MCPserve 文件夹，选择其中的 .py 文件进行安装。

💻 使用示例

基础用法

MCP 服务器允许 AI 助手与 Fusion 360 进行交互，例如：

访问设计数据：AI 可查询当前项目的基本信息、组件层次结构和参数。
执行操作：AI 能触发预定义的命令，如创建新草图或添加约束条件。

测试

命令行测试

在终端中运行以下命令验证服务器状态：

python client.py --test

图形界面测试

打开 Fusion 360。
安装并启用 MCP 服务器加成组件。
启动 MCP 监听服务：

python client.py --start

📄 许可证

该项目遵循 MIT 许可证，具体详情请查阅 LICENSE 文件。

致谢

模型上下文协议（MCP）提供了 Python SDK。
Autodesk Fusion 360 提供了强大的 CAD/CAM 平台。

贡献

欢迎大家为项目贡献力量！若有任何问题或建议，随时提交问题或拉取请求。

fusion-360-mcp-server