FreeCAD-Opencode-MCP
概览
本文档基于YouTube视频《我让GPT-6 Astra控制FreeCAD（它设计得像工程师）》（M5KOgtk9VfI）中的方法，并将其组织成实用的CAD自动化工作流程。 视频的核心是**它的制作方式。LLM生成FreeCAD Python代码，通过MCP桥接发送到FreeCAD，FreeCAD立即执行，并通过视口快照作为反馈，持续改进设计。 本指南将同一 FreeCAD MCP 服务器（neeka-nat/freecad-mcp）连接到 Opencode，利用 CLI 环境中相同的循环，同时优化以实现更实用的使用。 由于Opencode是MCP客户端，你可以直接连接视频中使用的FreeCAD MCP服务器。 - ： stdio（仅本地，最简单且最稳定）- ： FreeCAD 必须是 **，MCP 服务器才能连接并控制 FreeCAD。- ： 根据 MCP 工具响应（文档状态/快照等），Opencode 自主决定下一步操作。 ：安装uvx后，必须安装** 才能更新PATH。（参见视频步骤3） 本视频专门介绍ChatGPT Desktop，但由于本指南使用**，你可以在第一步跳过安装ChatGPT Desktop。 1. 从 freecad.org 下载兼容该操作系统的安装文件 2.继续安装（建议默认设置） 3.安装完成后，检查 FreeCAD 是否正在运行
概述（AI 翻译）
本文档基于YouTube视频*“我赋予GPT-6 Astra FreeCAD控制权（它设计得像工程师）”（M5KOgtk9VfI）的方法，总结了ChatGPT桌面MCP直接与Opencode（CLI代理）的集成方法，形成一个实用的CAD自动化工作流程。
1.概述
视频的核心是LLM如何通过MCP（模型上下文协议****）直接控制FreeCAD。LLM生成FreeCAD Python代码，通过MCP桥发送到FreeCAD，FreeCAD立即执行，并接收视口快照作为反馈，通过视觉反馈循环（观察→生成→执行→验证**持续改进设计。
本指南将同一 FreeCAD MCP 服务器（neeka-nat/freecad-mcp）连接到 Opencode，优化使其在 CLI 环境中利用相同的循环，同时更适合在任务结构化、文件/版本控制和验证自动化方面实际使用。
2.核心原则（视频摘要）
| 阶段 | 操作 | 描述 |
|---|---|---|
| 1 | 查询输入 | 用户用自然语言输入建模需求。 |
| 2 | 规划/工具调用 | 确定LLM将做什么，并决定MCP工具调用。 |
| 3 | 生成Python代码生成使用MCP在FreeCAD中运行的Python代码。 | |
| 4 | 运行 | FreeCAD MCP 服务器在 FreeCAD Python 环境中运行代码。 |
| 5 | 反馈收集 | FreeCAD通过MCP返回当前文档/视口状态（及快照）。 |
| 6 | 验证/迭代 | 在LLM对结果进行可视化和数值审查后，会发送纠正命令以迭代改进数据。 |
关键是将自然语言→FreeCAD Python API执行→可视化/状态反馈循环标准化到MCP中。
3.建筑
由于Opencode是MCP客户端，你可以直接连接视频中使用的FreeCAD MCP服务器。
本页由 AI 翻译，技术细节请以原文为准。
安装
uvx freecad-mcp配置
{
"mcpServers": {
"freecad": {
"type": "stdio",
"command": "uvx",
"args": ["freecad-mcp"],
"timeout": 120000
}
}
}