Fusion 360 MCP Server

Fusion 360 MCP Server

此仓库包含一个适用于 Autodesk Fusion 360 的 Model Context Protocol（MCP）服务。它支持 Claude 等 AI 助手使用 MCP 协议直接与 Fusion 360 交互。

概述

该服务以 Fusion 360 插件的形式实现，通过 MCP 提供 Fusion 360 的功能。这使 AI Agent 能够：

1. 获取当前设计的信息
2. 创建和修改设计元素
3. 接收针对 CAD 任务的上下文提示词

此仓库包含：

1. MCPserve/ - 实现 MCP 服务的 Fusion 360 插件
2. client.py - 用于验证服务功能的测试工具
3. install_mcp_for_fusion.py - 用于在 Fusion 360 的 Python 环境中安装 MCP 包的辅助脚本

工作原理

MCP 服务在 Fusion 360 中运行，并提供 AI Agent 可用的通信通道，以便：

1. 访问资源 - 获取当前设计、组件、参数等信息。
2. 使用工具 - 执行创建草图、添加参数或显示消息等操作。
3. 获取提示词 - 接收用于 CAD 相关任务的专用提示词模板。

要求

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

安装

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

Fusion 360 使用独立于系统 Python 的 Python 环境。必须在该环境中安装 MCP 包。

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

python install_mcp_for_fusion.py

此脚本将：

1. 查找系统中所有 Fusion 360 Python 安装
2. 为每个安装添加 CLI 扩展并安装 MCP 包
3. 验证安装是否成功

手动安装：

如果安装程序脚本无法运行，可以手动安装该包：

1. 找到 Fusion 360 的 Python 可执行文件（通常位于 Autodesk\webdeploy\production\[version]\Python）
2. 安装该包：

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

2. 安装 Fusion 360 插件

1. 在 Fusion 360 中，点击“Tools”选项卡 → “Add-Ins” → “Scripts and Add-Ins”
2. 点击“My Add-Ins”选项卡中的绿色“+”按钮
3. 浏览并选择此仓库中的 MCPserve 文件夹
4. 点击“Open”将其添加到插件列表
5. 选中它并点击“Run”以启动

将 MCP 服务与 AI 助手搭配使用

此服务支持 Claude 等 AI 助手以多种方式与 Fusion 360 交互：

资源

AI 助手可以访问以下资源：

• fusion://active-document-info - 当前活动文档的基本信息
• fusion://design-structure - 当前设计的详细结构
• fusion://parameters - 文档中定义的用户参数

工具

AI 助手可以使用以下工具：

• message_box - 在 Fusion 360 中显示消息框
• create_new_sketch - 在指定平面上创建新草图
• create_parameter - 使用指定值创建新参数

提示词

AI 助手可以使用专用提示词：

• create_sketch_prompt - 创建草图的专家指导
• parameter_setup_prompt - 设置参数的专家指导

测试服务

使用随附的客户端脚本测试服务是否正常运行：

python client.py --test-connection

测试特定功能：

# Test displaying a message box
python client.py --test-message-box

# Test listing available resources
python client.py --list-resources

# Test listing available tools
python client.py --list-tools

# Test listing available prompts
python client.py --list-prompts

通信方式

MCP 服务支持两种通信方式：

1. 通过 HTTP SSE 使用 MCP 协议 - 标准 MCP 协议实现，可通过 http://127.0.0.1:3000/sse 访问
2. 基于文件的通信 - 使用 mcp_comm 目录中的文件作为备用方式，适用于无法直接连接 HTTP 端点的环境

技术细节

服务器实现：

1. 在 Fusion 360 中作为后台线程运行，以保持响应速度
2. 自动创建就绪文件，以指示其可用
3. 使用 MCP 协议注册资源、工具和提示词
4. 在无法进行 HTTP 通信时，监控基于文件的命令

贡献

欢迎贡献！欢迎提交问题或拉取请求。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

• 感谢 Model Context Protocol (MCP) 提供 Python SDK
• 感谢 Autodesk Fusion 360 提供强大的 CAD/CAM 平台