内容
# 自由CAD自动化MCP服务器
将自由CAD的内部几何API暴露给AI代理，用于程序生成的设计和快速原型制作。
## 1. 价值主张
一个轻量级的Python桥接器，实现了 **模型上下文协议（MCP）**，允许LLM代理（如Claude Desktop或Gemini）直接在活跃的自由CAD会话中执行自然语言生成的CAD设计。
## 2. 主要功能
* **生成式CAD执行**：直接Python控制台访问，用于结构支架编译和几何放置。
* **预定义的参量蓝图**：快速工具动作，用于实心盒壳、圆柱体和结构安装支架。
* **无损XML-RPC链接**：干净的RPC网络循环，防止会话阻塞。
* **完全审计的配置**：本地配置模板，带有路径占位符，防止开发机器数据泄露。
## 3. 视觉演示和截图
## 4. 技术架构
```
+-----------------------------------+
| AI 客户端（例如Claude Desktop） |
+-----------------------------------+
|
| （模型上下文协议 / 标准输入输出）
v
+-----------------------------------+
| FastMCP 桥接服务器（bridge.py）| <-- 本项目
+-----------------------------------+
|
| （XML-RPC via HTTP - 端口 8000）
v
+-----------------------------------+
| 自由CAD 实例（活跃会话）|
+-----------------------------------+
```
桥接服务器拦截来自AI客户端的标准输入输出JSON-RPC命令，将它们翻译成Python执行代码块，并通过本地HTTP连接将它们分派到自由CAD的XML-RPC服务器工作台。
## 5. 安装说明和快速入门
### 先决条件
1. **自由CAD**：标准安装（推荐 v0.20+）。
2. **RPC 服务器工作台**：通过自由CAD的插件管理器安装“Robust MCP Bridge”或标准RPC服务器插件。将其设置为监听 `http://127.0.0.1:8000`。
### 设置
1. 克隆存储库并安装需求：
```bash
pip install -r requirements.txt
```
2. 运行桥接服务器：
```bash
python3 bridge.py
```
3. 配置您的Claude Desktop客户端配置（`claude_desktop_config.json`）：
```json
{
"mcpServers": {
"freecad-automation": {
"command": "python3",
"args": [
"/path/to/your/freecad-mcp-agent-bridge/bridge.py"
],
"env": {
"FREECAD_SERVER_URL": "http://127.0.0.1:8000"
}
}
}
}
```
## 6. 示例用法
提示AI代理：
> *"创建一个安装支架，宽度为60mm，长度为100mm，厚度为4mm，带有半径为3.5mm的中心安装孔。*
AI将调用工具 `create_bracket_part(width=60, length=100, thickness=4, hole_radius=3.5)`，该工具在自由CAD中立即编译支架。
## 7. 常见问题
### 问：为什么服务器超时？
确保自由CAD正在运行，并且XML-RPC服务器工作台正在端口8000上积极监听。参见[故障排除指南](./docs/troubleshooting.md)。
### 问：我可以执行自定义Python脚本吗？
是的，使用 `execute_freecad_python` 工具将原始Python脚本块传递到自由CAD中。
## 8. 相关项目和主题集群
查看GN3D Studio生态系统中的其他项目：
* [cadquery-parametric-casings](https://github.com/gn3dstudio/cadquery-parametric-casings) - 程序化CAD蓝图脚本。
* [industrial-fdm-print-profiles](https://github.com/gn3dstudio/industrial-fdm-print-profiles) - 高性能复合材料打印配置。
* [fdm-print-failure-analysis](https://github.com/gn3dstudio/fdm-print-failure-analysis) - 机械打印失败的经验数据集。
## 9. 相关资源
* [故障排除指南](./docs/troubleshooting.md)
* [变更日志](./CHANGELOG.md)
* [学术引用配置文件](./CITATION.cff)
* [MIT 许可证](./LICENSE)
## 关于 GN3D Studio
**工业3D打印和快速原型制作**
* **网站**：[https://gn3dstudio.com](https://gn3dstudio.com)
* **服务**：
* 定制3D打印
* 快速原型制作
* 功能原型
* 工程零件
* CAD自动化
* **位置**：越南胡志明市
