FreeCAD MCP (模型控制协议)

概述

FreeCAD MCP（Model Control Protocol）通过服务器-客户端架构提供了一个简化的接口，用于与FreeCAD交互。这允许用户执行命令并获取当前FreeCAD文档和场景的信息。

https://github.com/user-attachments/assets/5acafa17-4b5b-4fef-9f6c-617e85357d44

配置

要配置MCP服务器，您可以使用JSON格式指定服务器设置。以下是示例配置：

{
    "mcpServers": {
        "freecad": {
            "command": "C:\\ProgramData\\anaconda3\\python.exe",
            "args": [
                "C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
            ]
        }
    }
}

配置详细信息

• command: 运行MCP服务器的Python可执行文件路径。根据您的操作系统，这可能会有所不同：

  • Windows: 类似于 C:\\ProgramData\\anaconda3\\python.exe 或 C:\\Python39\\python.exe。
  • Linux: 可能类似于 /usr/bin/python3 或您安装的Python路径。
  • macOS: 通常为 /usr/local/bin/python3 或您安装的Python路径。

• args: 传递给Python命令的参数数组。第一个参数应该是 freecad_bridge.py 脚本的路径，该脚本负责处理MCP服务器逻辑。请根据您的安装调整路径。

不同操作系统的示例

Windows

{
    "mcpServers": {
        "freecad": {
            "command": "C:\\ProgramData\\anaconda3\\python.exe",
            "args": [
                "C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
            ]
        }
    }
}

Linux

{
    "mcpServers": {
        "freecad": {
            "command": "/usr/bin/python3",
            "args": [
                "/home/USER/.FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
            ]
        }
    }
}

macOS

{
    "mcpServers": {
        "freecad": {
            "command": "/usr/local/bin/python3",
            "args": [
                "/Users/USER/Library/Preferences/FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
            ]
        }
    }
}

功能

• 功能1: 描述第一个功能。
• 功能2: 描述第二个功能。
• 功能3: 描述第三个功能。

示例

以下是如何使用MCP服务器的示例：

# 示例代码
print("Hello, MCP!")

安装

按照以下步骤安装FreeCAD MCP:

1. 将所有内容复制到剪贴板。
2. 打开FreeCAD。
3. 进入“工具”菜单，选择“自定义我的工作bench”。
4. 粘贴内容并保存。

贡献

欢迎提交问题或拉取请求。您的反馈和贡献都很宝贵！

许可证

此项目 licensed under the MIT License。有关详细信息，请参见LICENSE文件。