Fusion 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_addon.py): 一个 Fusion 360 插件，连接到 MCP 服务器并提供与 Fusion 360 API 的实际集成。

安装

服务器和客户端

1. 克隆此存储库或将文件复制到所需位置。
2. 确保已安装 Python 3.6+。
3. 不需要额外的 Python 包，因为该实现仅使用标准库模块。

Fusion 360 插件

1. 在 Fusion 360 中，转到“脚本和插件”对话框（按 Shift+S 或在“设计”工作区的“实用程序”下找到它）。
2. 单击“插件”选项卡，然后单击“我的插件”旁边的“+”图标。
3. 导航到插件文件的位置，然后选择包含 fusion360_mcp_addon.py 的文件夹。
4. 单击“运行”以启动插件，或单击“启动时运行”以使其在 Fusion 360 启动时自动加载。

用法

启动服务器

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

python server.py

默认情况下，服务器将在 127.0.0.1:8080 上侦听。如果需要，可以在代码中修改主机和端口。

将 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()

协议

服务器和客户端使用基于 JSON 的简单协议通过 TCP 套接字进行通信。 每条消息都是一个 JSON 对象，其中至少包含一个 type 字段，指示消息类型。

消息类型

• fusion_command: 在 Fusion 360 中执行命令
• get_model_info: 请求有关当前模型的信息
• command_result: 包含命令执行结果的响应
• model_info: 包含模型信息的响应

扩展

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

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

许可证

本项目按原样提供，不提供任何保证。 使用风险自负。

贡献

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