Fusion MCP Server (Joe Spencer)

Fusion 360 MCP服务器

此存储库包含用于Autodesk Fusion 360的模型上下文协议（MCP）服务器。它使像克劳德这样的人工智能助手能够使用MCP协议直接与Fusion 360交互。

概述

该服务器被实现为Fusion 360插件，通过MCP公开Fusion 360的功能。这使得AI代理能够：

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代理可以使用该信道：

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中，单击“工具”选项卡→ “附加模块”→ “脚本和加载项”
2. 单击“我的加载项”选项卡中的绿色“+”按钮
3. 浏览并选择 MCPserve 此存储库中的文件夹
4. 单击“打开”将其添加到您的加载项中
5. 选择它并单击“运行”以启动它

使用带有AI助手的MCP服务器

该服务器使像克劳德这样的人工智能助手能够通过多种方式与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许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

• 模型上下文协议（MCP） Python SDK
• Autodesk Fusion 360，强大的CAD/CAM平台