MCP 服务器

freecad mcp

这个仓库是一个 FreeCAD MCP，它允许你从 Claude Desktop 控制 FreeCAD。

Tools

get_object

Get an object from a document. You can use this tool to get the properties of an object to see what you can check or edit. Args: doc_name: The name of the document to get the object from. obj_name: The name of the object to get. Returns: The object and a screenshot of the object.

get_parts_list

Get the list of parts in the parts library addon.

create_document

Create a new document in FreeCAD. Args: name: The name of the document to create. Returns: A message indicating the success or failure of the document creation. Examples: If you want to create a document named "MyDocument", you can use the following data. ```json { "name": "MyDocument" } ```

create_object

Create a new object in FreeCAD. Args: doc_name: The name of the document to create the object in. obj_type: The type of the object to create (e.g. 'Part::Box', 'Part::Cylinder', 'Draft::Circle', 'PartDesign::Body', etc.). obj_name: The name of the object to create. obj_properties: The properties of the object to create. Returns: A message indicating the success or failure of the object creation and a screenshot of the object. Examples: If you want to create a cylinder with a height of 30 and a radius of 10, you can use the following data. ```json { "doc_name": "MyCylinder", "obj_name": "Cylinder", "obj_type": "Part::Cylinder", "obj_properties": { "Height": 30, "Radius": 10, "Placement": { "Base": { "x": 10, "y": 10, "z": 0 }, "Rotation": { "Axis": { "x": 0, "y": 0, "z": 1 }, "Angle": 45 } }, "ViewObject": { "ShapeColor": [0.5, 0.5, 0.5, 1.0] } } } ``` If you want to create a circle with a radius of 10, you can use the following data. ```json { "doc_name": "MyCircle", "obj_name": "Circle", "obj_type": "Draft::Circle", } ``` If you want to create a FEM analysis, you can use the following data. ```json { "doc_name": "MyFEMAnalysis", "obj_name": "FEMAnalysis", } ```

edit_object

Edit an object in FreeCAD. This tool is used when the `create_object` tool cannot handle the object creation. Args: doc_name: The name of the document to edit the object in. obj_name: The name of the object to edit. obj_properties: The properties of the object to edit. Returns: A message indicating the success or failure of the object editing and a screenshot of the object.

delete_object

Delete an object in FreeCAD. Args: doc_name: The name of the document to delete the object from. obj_name: The name of the object to delete. Returns: A message indicating the success or failure of the object deletion and a screenshot of the object.

execute_code

Execute arbitrary Python code in FreeCAD. Args: code: The Python code to execute. Returns: A message indicating the success or failure of the code execution and a screenshot of the object.

get_view

Get a screenshot of the active view. Args: view_name: The name of the view to get the screenshot of. The following views are available: - "Isometric" - "Front" - "Top" - "Right" - "Back" - "Left" - "Bottom" - "Dimetric" - "Trimetric" Returns: A screenshot of the active view.

insert_part_from_library

Insert a part from the parts library addon. Args: relative_path: The relative path of the part to insert. Returns: A message indicating the success or failure of the part insertion and a screenshot of the object.

get_objects

Get all objects in a document. You can use this tool to get the objects in a document to see what you can check or edit. Args: doc_name: The name of the document to get the objects from. Returns: A list of objects in the document and a screenshot of the document.

README

FreeCAD MCP

这是一个 FreeCAD MCP，允许你从 Claude Desktop 控制 FreeCAD。

演示

设计一个法兰

demo

设计一个玩具车

demo

从 2D 图纸设计零件

输入 2D 图纸

input

演示

demo

安装插件

FreeCAD 插件目录是：

Windows: %APPDATA%\FreeCAD\Mod\
Mac: ~/Library/Application Support/FreeCAD/Mod/
Linux: ~/.FreeCAD/Mod/ 或 ~/snap/freecad/common/Mod/ (如果你从 snap 安装 FreeCAD)

请将 addon/FreeCADMCP 目录放入插件目录。

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

安装插件后，你需要重启 FreeCAD。你可以从工作台列表中选择 "MCP Addon" 并使用它。

workbench_list

并且你可以通过 "FreeCAD MCP" 工具栏中的 "Start RPC Server" 命令启动 RPC 服务器。

start_rpc_server

设置 Claude Desktop

编辑 claude_desktop_config.json 文件。

对于用户。

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

对于开发者。首先，你需要克隆此仓库。

git clone https://github.com/neka-nat/freecad-mcp.git

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}