freecad-mcp — Claude MCP 必备工具中文教程

Install addon

FreeCAD Addon directory is Windows: %APPDATA%\FreeCAD\Mod\ Mac: FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/ FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/Mod/ Linux: Ubuntu: ~/.FreeCAD/Mod/ or ~/snap/freecad/common/Mod/ (if you install FreeCAD from snap) Debian: ~/.local/share/FreeCAD/Mod Arch / CachyOS (FreeCAD 1.1 from extra/freecad): ~/.local/share/FreeCAD/v1-1/Mod/

Please put addon/FreeCADMCP directory to the addon directory.

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

Demo

Setting up Claude Desktop

Pre-installation of the uvx is required.

And you need to edit Claude Desktop config file, claude_desktop_config.json.

For user.

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

If you want to save token, you can set only_text_feedback to true and use only text feedback.

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

For developer. First, you need clone this repository.

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

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