融合360 MCP服务器

Autodesk Fusion 360的主控程序（MCP）服务器，支持远程控制和自动化Fusion 360操作。

概述

该项目实现了一个客户端-服务器架构，允许外部应用程序与Fusion 360进行交互。服务器作为客户端与Fusion 360 API之间的桥梁，实现了命令的远程执行和模型信息的检索。

组件

项目由三个主要组件组成：

1. MCP服务器 (server.py)：一个独立的Python服务器，监听来自客户端的连接，并与Fusion 360通信。
2. MCP客户端 (client.py)：一个Python客户端库，连接到MCP服务器并提供发送命令和接收响应的方法。
3. Fusion 360插件 (fusion360_mcp_addin.py)：一个Fusion 360插件，连接到MCP服务器并提供与Fusion 360 API的实际集成。

安装

服务器和客户端

1. 克隆此仓库或将文件复制到您希望的位置。

2. 确保安装了Python 3.6+。

3. 基本功能不需要额外的Python包，因为实现仅使用标准库模块。

4. 若要启用LLM功能，请安装可选的openai包：

   pip install openai
   

Fusion 360插件

1. 将包含fusion360_mcp_addin.py、client.py和resources目录的整个文件夹复制到您的Fusion 360 插件目录中。确保resources/MCPIcon文件夹包含所需的图标文件（32x32-normal.png和16x16-normal.png）。
2. 在Fusion 360中，打开“脚本和插件”对话框（按Shift+S或在“设计”工作区下的“实用工具”中找到它）。
3. 在“插件”标签页中选择从我的计算机加载（某些版本中为“从设备加载”），然后选择这个文件夹。选择文件夹会启动插件。
4. 单击“运行”或启用“启动时运行”，以便在启动Fusion 360时自动加载。

使用

启动服务器

1. 打开命令提示符或终端。
2. 导航到包含服务器文件的目录。
3. 运行服务器：

python server.py

默认情况下，服务器将在127.0.0.1:8080上监听。如果需要，可以在代码中修改主机和端口。如果您计划使用LLM集成，请设置OPENAI_API_KEY环境变量。

将Fusion 360连接到服务器

1. 启动Fusion 360并确保MCP插件正在运行。
2. 在Fusion 360中，查找“MCP控制”面板。
3. 单击“连接到MCP服务器”按钮。
4. 输入服务器主机和端口，然后单击确定。
5. 如果成功，您将看到确认消息。

使用客户端

您可以使用提供的客户端实现连接到服务器并与Fusion 360进行交互：

from client import MCPClient

# 创建并连接客户端
client = MCPClient('127.0.0.1', 8080)
if client.connect():
    # 获取模型信息
    client.get_model_info()
    
    # 执行Fusion 360命令
    client.execute_fusion_command('create_circle', {
        'center': [0, 0, 0],
        'radius': 10
    })
    
    # 完成后断开连接
    client.disconnect()

协议

服务器和客户端通过TCP套接字上的简单基于JSON的协议进行通信。每个消息都是一个至少具有type字段的JSON对象，该字段指示消息类型。

消息类型

• fusion_command：在Fusion 360中执行命令
• get_model_info：请求当前模型的信息
• command_result：包含命令执行结果的响应
• model_info：包含模型信息的响应
• llm_request：请求配置的LLM生成文本
• llm_result：包含LLM输出的响应

扩展

您可以扩展服务器和插件以支持更多功能：

1. 向协议添加新的消息类型
2. 在服务器中实现这些消息类型的处理程序
3. 在客户端中添加相应的方法
4. 在Fusion 360插件中实现实际功能

许可证

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

贡献

欢迎贡献！请随时提交Pull Request。

注意事项

• Fusion 360 (2601.1.34) MCP插件拒绝安装，错误显示有多个文件。
  • 创建一个新的插件（Python），编辑，将fusion360_mcp_addin.py源代码复制到新文件中，保存，打开新文件位置并将client.py和resource文件夹复制到该位置，重启Fusion 360。