Fusion 360 MCP 服务器

此仓库包含一个用于 Autodesk Fusion 360 的模型上下文协议 (MCP) 服务器。它使像 Claude 这样的人工智能助手能够使用 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. 选择它并单击“运行”以启动它

将 MCP 服务器与 AI 助手一起使用

该服务器使像 Claude 这样的人工智能助手能够以多种方式与 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

要测试特定功能：

# 测试显示消息框
python client.py --test-message-box

# 测试列出可用资源
python client.py --list-resources

# 测试列出可用工具
python client.py --list-tools

# 测试列出可用提示
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 文件。

致谢

• 模型上下文协议 (MCP) 用于 Python SDK
• Autodesk Fusion 360 用于强大的 CAD/CAM 平台