autodesk-fusion-mcp-python

# Autodesk Fusion 360 MCP 集成 Fusion MCP（模型上下文协议）应用程序是一个集成系统，使 AI 助手能够以编程方式与 Autodesk Fusion 360 进行交互。该实现特别演示了如何通过简单的 API 调用创建参数化 3D 模型，弥合了对话式 AI 和 CAD 软件之间的差距。 ## 概述 Fusion 360 MCP 集成使 AI 助手能够控制 Fusion 360 进行 3D 建模任务。该项目对于以下方面尤为宝贵： - AI 辅助 CAD 设计工作流程 - 参数化 3D 模型生成 - 在 Fusion 360 中自动化重复设计任务 - 为 Fusion 360 创建程序接口 ## 组件 该集成由三个主要组件组成： ### 1. LiveCube 脚本（`LiveCube.py` 和 `LiveCube.manifest`） 一个 Fusion 360 插件： - 在 Fusion 360 中作为脚本运行 - 创建具有指定尺寸的参数化立方体 - 在端口 18080 上公开一个 HTTP 端点以接收命令 - 可以通过简单的 HTTP GET 请求触发 ### 2. Fusion 服务器（`fusion_server.py`） 一个中间服务器： - 作为 MCP 和 Fusion 360 之间的桥梁 - 监听端口 8000 以接收 MCP 请求 - 将 MCP 调用转换为 Fusion 360 可以理解的格式 - 处理与 LiveCube 脚本的通信 ### 3. MCP 服务器（`fusion_mcp.py`） 模型上下文协议服务器： - 提供 AI 助手可以使用的工具 - 与 Autodesk 平台服务（APS）集成以进行云自动化 - 提供用于创建参数化立方体的 `generate_cube` 工具 - 使用 OAuth 身份验证以安全访问 APS ## 功能 - **立方体创建**：生成具有指定尺寸的参数化立方体 - **Autodesk 平台服务集成**：使用 APS 设计自动化进行复杂操作 - **简单的 HTTP 接口**：易于使用的 Fusion 360 控制 API - **MCP 标准合规性**：与任何 MCP 兼容的 AI 助手一起工作 ## 安装 ### 先决条件 - Autodesk Fusion 360（2023 或更新版本） - Python 3.9+ 及 pip - 具有 API 访问权限的 Autodesk 平台服务帐户 - MCP 兼容的 AI 助手（例如 Windsurf 环境中的 Claude） ### 设置说明 1. **安装 Python 依赖项**： ```bash pip install -r requirements.txt ``` 2. **设置环境变量**： 创建一个包含 Autodesk 平台服务凭证的 `keys.env` 文件： ``` APS_CLIENT_ID=your_client_id APS_CLIENT_SECRET=your_client_secret FUSION_ACTIVITY_ID=your_activity_id ``` 3. **在 Fusion 360 中安装 LiveCube 脚本**： - 打开 Fusion 360 - 导航到脚本和插件（Shift+S） - 点击绿色“+”按钮并选择“添加脚本” - 浏览并选择此仓库中的 `LiveCube` 文件夹 - 脚本现在应该出现在您的脚本列表中 ## 使用 ### 启动服务器 1. **启动 Fusion 服务器**： ```bash python fusion_server.py ``` 这将启动监听 http://localhost:8000 2. **运行 LiveCube 脚本**： - 在 Fusion 360 中，前往脚本和插件 - 选择 LiveCube 并点击“运行” - 这将在 Fusion 360 中启动端口 18080 上的 HTTP 服务器 3. **启动 MCP 服务器**： ```bash python fusion_mcp.py ``` 这将启动 MCP 服务器，默认为 stdio 传输。 ### 与 AI 助手配合使用 配置您的 MCP 兼容 AI 助手以连接到 Fusion MCP 服务器。例如，使用 Claude Desktop： ```json { "mcpServers": { "fusion": { "command": "python", "args": ["/path/to/fusion_mcp.py"] } } } ``` AI 然后可以使用 `generate_cube` 工具在 Fusion 360 中创建立方体。 ### 直接 API 访问 您还可以直接与 LiveCube 脚本的 HTTP 端点交互： ``` GET http://127.0.0.1:18080/cmd?edge=50 ``` 这将在 Fusion 360 中创建一个边长为 50mm 的立方体。 ## 开发人员说明 - MCP 服务器使用 OAuth 2.0 身份验证与 Autodesk 平台服务（APS）通信 - 对于高级用例，请修改 `fusion_mcp.py` 以添加除立方体创建之外的其他工具 - 可以通过在 `fusion_server.py` 中添加新处理程序和相应的 Fusion 360 脚本来扩展系统架构以支持其他 Fusion 360 操作 ## 许可证 MIT ## 致谢 - 感谢 @damianengineer 和 @ydooWoody 的贡献！ - 感谢 YCombinator 举办的世界最大 MCP 黑客马拉松：https://lu.ma/t4zeld9m?tk=67ixxD - Autodesk 提供 Fusion 360 API 和平台服务 - 模型上下文协议（MCP）创建者为实现 AI 工具互操作性 ### 或显式指定_stdio_ ```shell npx @modelcontextprotocol/server-everything stdio ``` ### 运行 SSE 服务器 ```shell npx @modelcontextprotocol/server-everything sse ``` ### 运行可流式 HTTP 服务器 ```shell npx @modelcontextprotocol/server-everything streamableHttp ```