FreeCAD MCP

Servidor MCP de neka-nat

Control FreeCAD from an MCP client to create and edit 3D models, run Python scripts and run FEM analyses.

Se ejecuta en local (Se ejecuta en tu equipo: su página tiene el comando de instalación)Se ejecuta con uvx

Instalar FreeCAD MCP

Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:

uvx freecad-mcp

Requiere uv (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.

Compartir este servidor

Abre esta página, con el comando de instalación y los pasos de configuración.

mcp.tc/i/freecad

Descripción

Connects an MCP client such as Claude Desktop to FreeCAD. You can create and edit 3D models, inspect documents, run Python scripts inside FreeCAD and run FEM analyses.

It runs locally over stdio with uvx freecad-mcp. It has two parts: an addon (addon/FreeCADMCP in the repository) installed in FreeCAD, and the MCP server started by your client. The addon's RPC server must be running in FreeCAD, and connections use localhost by default. No API key or sign-in is needed.

Qué puedes hacer

  • Create and edit models in FreeCAD
  • Run Python scripts inside FreeCAD
  • Inspect FreeCAD documents
  • Run FEM analyses
  • Connect to FreeCAD on localhost or a remote host

Herramientas

Los servidores locales muestran sus herramientas cuando están en marcha, y este no publica su lista por adelantado. Tu cliente las muestra después de añadirlo.

Prompts de ejemplo

  • Design a flange in FreeCAD with six bolt holes.

  • Inspect the open FreeCAD document and list its objects.

  • Run a Python script in FreeCAD to add a fillet to the selected edges.

  • Set up a FEM analysis for this bracket.

Configuración

Todos los clientes inician FreeCAD MCP en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio freecad -- uvx freecad-mcp
  1. Start Claude Code and type /mcp. freecad should show as connected.

Add --scope user to make it available in every project.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

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

Needs uv (Python) on your computer.

VS Code

Or from a terminal:

code --add-mcp '{"name":"freecad","type":"stdio","command":"uvx","args":["freecad-mcp"]}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "freecad": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

Needs uv (Python) on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add freecad -- uvx freecad-mcp

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.freecad]
command = "uvx"
args = ["freecad-mcp"]

Needs uv (Python) on your computer.

Gemini CLI

gemini mcp add freecad uvx freecad-mcp

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs uv (Python) on your computer.

Preguntas frecuentes

Can I paste mcp.tc/i/freecad into my MCP client?

No. FreeCAD MCP runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is uvx freecad-mcp.

Does FreeCAD MCP need an API key?

No. It doesn’t declare any keys or environment variables. It runs with your user account’s permissions, so check what its tools can reach.

Is FreeCAD MCP a remote or a local server?

Local. Your client starts it as a process on your computer with uvx freecad-mcp, which needs uv (Python).

What can FreeCAD MCP do?

You can create and edit models in FreeCAD, run Python scripts inside FreeCAD y inspect FreeCAD documents.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc’s robot read FreeCAD MCP’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

Insertar

Muestra FreeCAD MCP en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones

Insignia para README

Vista previa de la insignia, claraVista previa de la insignia, oscura
Markdown
[![FreeCAD MCP on mcp.tc](https://mcp.tc/i/freecad/badge.svg)](https://mcp.tc/i/freecad)
HTML
<a href="https://mcp.tc/i/freecad"><img src="https://mcp.tc/i/freecad/badge.svg" alt="FreeCAD MCP on mcp.tc" height="20"></a>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML
<script src="https://mcp.tc/w/freecad.js" async></script>

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/freecad" title="FreeCAD MCP on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

https://mcp.tc/i/freecad.json

Qué significa cada campo

mcp.tc no tiene relación con neka-nat. Esta página se creó a partir de los metadatos públicos de FreeCAD MCP, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha.