星战科技xingzhan.cloud
返回市场
融合-MCP服务器

融合-MCP服务器

作者：Joe-Spencer8 星标更新：2025-04-23
安装使用来源：spider==github.com

项目介绍

Fusion 360 MCP 服务器

此仓库包含一个用于 Autodesk Fusion 360 的模型上下文协议（MCP）服务器。它使像 Claude 这样的AI助手能够通过 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 这样的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

要测试特定功能：

# 测试显示消息框
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. 基于文件的通信 - 在无法直接连接到HTTP端点的环境中使用的备份方法，使用 mcp_comm 目录中的文件

技术细节

服务器实现：

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

贡献

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

许可证

该项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。

致谢