build123d-mcp

Un servidor MCP (Model Context Protocol) que expone las operaciones CAD de build123d como herramientas, permitiendo a los asistentes de IA construir, inspeccionar e iterar sobre geometría 3D de forma interactiva.

Por qué

Al usar una IA para escribir scripts de build123d, la IA escribe a ciegas: no puede ver la geometría que produce. Este servidor cierra el bucle de retroalimentación: la IA puede crear geometría, renderizar vistas, consultar dimensiones y detectar errores de forma incremental en lugar de escribir scripts completos esperando que sean correctos.

Related MCP server: 3D MCP Server

Herramientas

• execute — ejecuta código Python de build123d en una sesión persistente; usa show(shape, name) para registrar piezas con nombre

• render_view — renderiza una o más formas como PNG o SVG; admite composición de ensamblajes, teselación de alta calidad y planos de corte de sección transversal

• measure — consulta el cuadro delimitador, volumen, área de superficie, topología, grosor mínimo de pared o espacio libre entre dos cuerpos con nombre

• export — exporta como STEP, STL o ambos en una sola llamada; apunta a un objeto con nombre o a la forma actual

• session_state — instantánea JSON completa de formas activas, objetos con nombre y nombres de instantáneas

• health_check — verifica que las dependencias VTK/SVG/STEP/STL funcionen de extremo a extremo antes de comenzar a trabajar

• save_snapshot / restore_snapshot / diff_snapshot — punto de control, recuperación y comparación del estado geométrico

• interference — verifica el volumen de intersección entre dos formas con nombre

• list_objects — enumera todas las formas con nombre con estadísticas de geometría

• version — devuelve la versión del servidor

• reset — restablece la sesión al estado vacío

Consulta llms.md para obtener la referencia completa de herramientas y patrones de uso.

Requisitos

• uv

• Un cliente compatible con MCP (Claude Code, Claude Desktop, Cursor, etc.)

Todas las dependencias de Python (build123d, vtk, etc.) se instalan automáticamente mediante uv.

Instalación

No se necesita clonar. Instala directamente desde PyPI:

pip install build123d-mcp

O simplemente usa uv tool run: descarga y ejecuta el paquete en un solo paso sin necesidad de instalación previa (ver más abajo).

Añadir a clientes MCP

El servidor se ejecuta sobre stdio: el cliente lo inicia como un subproceso usando uv tool run build123d-mcp.

Nota sobre la versión de Python. Todos los ejemplos a continuación pasan --python 3.12. VTK y cadquery-ocp aún no distribuyen ruedas para Python 3.13+, por lo que es necesario fijar la versión en 3.12. uv descargará automáticamente un Python 3.12 gestionado si aún no tienes uno.

Claude Code

Añádelo al .mcp.json de tu proyecto (o ~/.claude/mcp.json para uso global):

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Reinicia Claude Code después de editar. Las herramientas aparecen automáticamente una vez conectadas.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Abre Settings → MCP y añade una nueva entrada de servidor, o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

VS Code (GitHub Copilot / Continue)

Para la extensión Continue, añade a .continue/config.json:

{
  "mcpServers": [
    {
      "name": "build123d-mcp",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  ]
}

Para GitHub Copilot con soporte MCP, añade a .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "build123d-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Prompt del sistema

Para obtener los mejores resultados, pega el contenido de default_prompt.md como prompt del sistema en tu cliente de IA. Esto le indica al asistente que trabaje de forma incremental, verifique la geometría después de cada paso y utilice las herramientas en el orden correcto.

Estado

Desarrollo activo (v0.1.0).