SolidworksMCP

SolidworksMCP es un servidor de Protocolo de Contexto de Modelo orientado a producción para controlar una sesión activa de SOLIDWORKS a través de la API COM de Windows.

Este es un fork de alisamsam/Solidworks-MCP que lo amplía de 82 a 143 herramientas, añadiendo dibujos, edición de ensamblajes, chapa metálica, exportación de paquetes de fabricación y trazado de referencias de documentos. Consulte Qué añade este fork.

Versión actual: 6.5.31. La versión fue probada de aceptación con SOLIDWORKS 2026 SP2.1 y conserva protecciones de compatibilidad para SOLIDWORKS 2025.

Aspectos destacados

• Operaciones nativas de croquis, funciones, cuerpos, geometría de referencia, vistas, sondas y exportación.

• Planes CAD transaccionales con puntos de control, invariantes, idempotencia, presupuestos y reversión.

• Croquis paramétricos con entidades nombradas, restricciones, cotas, ecuaciones, ID persistentes y análisis de grados de libertad.

• Herramientas multicuerpo con alcance de fusión explícito, holgura, interferencia, caja delimitadora y verificación de volumen.

• Canalizaciones deterministas de ráster a croquis para siluetas y arte lineal, incluida segmentación respaldada por GPU, preservación de topología, ajuste de primitivas y puertas de calidad de ráster inverso.

• Exportación nativa de croquis/cuerpo y comparación geométrica calibrada en lugar de aceptación solo por captura de pantalla.

• Normal a y Ajustar a pantalla verificados del croquis activo. El servidor lee la matriz de cámara resultante y la ocupación de píxeles en lugar de confiar en un comando de interfaz.

• Documentos de dibujo de extremo a extremo: láminas, vistas, anotaciones de modelo, cotas manuales, notas, globos, marcas de centro y tablas de lista de materiales.

• Edición de ensamblajes: componentes, relaciones de posición, patrones, supresión, reemplazo y vistas explosionadas.

• Chapa metálica desde la brida base hasta el DXF de patrón plano, y un paquete de fabricación de una sola llamada que exporta STEP, DXF y PDF para un ensamblaje completo.

• Búsqueda de documentos y trazado de referencias en ambas direcciones, incluido el uso en un proyecto (where-used) en una carpeta de proyecto.

• Diagnósticos estructurados, verificación previa de diálogos modales, un vigilante de Modify de alcance limitado y políticas de recuperación finitas.

Related MCP server: solidworks-mcp

Qué añade este fork

Este repositorio es un fork de alisamsam/Solidworks-MCP. La versión original exponía 82 herramientas que cubrían croquis, funciones sólidas, cuerpos, sondas, vectorización y la capa transaccional. Este fork lo lleva a 143 herramientas y la suite de pruebas de 155 a 382 pruebas, todas las cuales pasan.

Las adiciones siguen la disciplina que el proyecto original ya estableció: no se confía en ningún valor de retorno COM. Cada nueva operación lee el estado resultante (recuentos de anotaciones, listas de componentes, indicadores de supresión, recuentos de caras, archivos en disco) y reporta fallo cuando el modelo no muestra realmente el cambio, en lugar de cuando la API lo dice.

Dibujos (17 herramientas)

El proyecto original no tenía soporte para documentos de dibujo. Este fork cubre la ruta completa de acotación: create_new_drawing, add_sheet, activate_sheet, list_sheets, insert_drawing_view, insert_standard_views, insert_section_view, insert_detail_view, list_drawing_views, set_view_scale, insert_model_annotations, insert_bom_table, add_drawing_dimension, insert_drawing_note, insert_balloons, insert_center_marks y list_drawing_annotations.

Las vistas y anotaciones se verifican contando lo que apareció en la lámina; CreateDrawViewFromModelView3 e InsertModelAnnotations3 ambos reportan éxito para vistas y anotaciones que nunca se crearon.

Ensamblajes (14 herramientas)

El proyecto original se detenía al abrir un ensamblaje. Este fork añade trabajo de componentes y relaciones de posición: insert_component, list_components, add_mate, delete_mate, list_mates, set_component_fixed, check_assembly_interference, delete_component, replace_component, set_component_suppression, pattern_components, explode_assembly, show_exploded y list_exploded_views.

Chapa metálica (6 herramientas)

La chapa metálica es la única disciplina de piezas cuyo entregable no es el sólido sino el patrón plano: el DXF que consume un láser o una punzonadora. create_base_flange engrosa un croquis en un cuerpo de chapa metálica; convert_to_sheet_metal convierte un sólido existente en uno, que es la ruta que debe tomar la geometría importada, ya que un STEP de un soporte doblado no lleva información de doblez; create_edge_flange dobla bridas desde bordes sin un croquis de perfil; set_flat_pattern aplana o pliega; export_flat_pattern escribe el DXF o DWG; get_sheet_metal_info reporta el espesor, radio, factor K y extensiones del patrón plano que una cotización o una ejecución de anidamiento necesita.

ExportFlatPatternView reporta éxito para una pieza cuyo patrón plano falló al construirse, por lo que la exportación se verifica contra el archivo en disco. La función de patrón plano se encuentra por su nombre de tipo de API en lugar de su nombre mostrado, porque los nombres mostrados están localizados.

Paquete de fabricación (1 herramienta)

export_manufacturing_package produce la carpeta que realmente recibe el taller, en una sola llamada: un STEP para cada pieza y para el ensamblaje, un DXF para cada pieza de chapa metálica, un PDF del dibujo que se encuentra junto a cada modelo, y un manifest.json que lista cada archivo con el material y la masa de cada pieza. Recorre un ensamblaje componente por componente, por lo que una máquina de veinte piezas toma una llamada en lugar de sesenta. Los documentos que tuvo que abrir se cierran de nuevo al final y se restaura el documento originalmente activo.

Búsqueda de documentos y referencias (3 herramientas)

search_documents encuentra archivos de SolidWorks en una carpeta por fragmento de nombre y tipo. list_document_references reporta lo que un documento utiliza y si cada uno de esos archivos sigue en disco. find_where_used responde la pregunta inversa: qué ensamblajes y dibujos usan esta pieza, que SolidWorks no puede responder directamente, ya que un documento registra lo que referencia y nunca lo que lo referencia. El mapa inverso se construye leyendo las dependencias de cada ensamblaje y dibujo en un árbol de carpetas, lo cual es asequible solo porque GetDocumentDependencies2 lee las referencias de un archivo sin abrirlo.

Funciones (5 herramientas)

create_loft, create_rib, apply_draft, simple_hole y hole_wizard, cada una con la protección de función muerta: una función que reporta éxito mientras no añade geometría se elimina en lugar de dejarse en el árbol.

Configuraciones, propiedades y parámetros (15 herramientas)

activate_configuration, list_configurations, list_custom_properties, set_custom_property, delete_custom_property, get_material, set_material, get_mass_properties, get_dimension, set_dimension, add_equation, set_equation, delete_equation, list_equations y rebuild_document.

ShowConfiguration2 es uno de los mentirosos verificados: devuelve éxito para una configuración que nunca se activó, por lo que la configuración activa se lee de nuevo después.

Más allá de las herramientas

• Los esquemas de herramientas se movieron de server.py a un paquete schemas/ agrupado por familia, lo que redujo server.py de 3819 líneas a 2300.

• Metadatos de empaquetado (pyproject.toml), un extra separado vision para el backend de PyTorch de varios gigabytes, y un flujo de trabajo de GitHub Actions que ejecuta la suite.

• LICENSE registra tanto a los titulares de derechos de autor como lo que cambia el fork.

Requisitos

• Windows 10 o Windows 11.

• SOLIDWORKS 2025 o 2026, instalado y con licencia.

• Python 3.10 o más reciente; Python 3.11 es el tiempo de ejecución probado de aceptación.

• Git LFS para los puntos de control de arte lineal empaquetados.

• Se recomienda encarecidamente un entorno NVIDIA CUDA para los modos de vectorización profunda. get_capabilities reporta el estado real del backend.

El servidor controla el proceso interactivo de SOLIDWORKS. No es un núcleo CAD sin cabeza, y un diálogo modal desconocido debe ser inspeccionado por un humano.

Clonar e instalar

Instale Git LFS antes de clonar, o extraiga los objetos del modelo después:

git lfs install
git clone https://github.com/aryesil/SolidworksMCP.git
Set-Location SolidworksMCP
git lfs pull

Cree un entorno de Python aislado e instale el paquete:

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .

La instalación base cubre todas las herramientas excepto la vectorización profunda de siluetas, cuyo backend de PyTorch vive en el extra vision:

python -m pip install -e ".[vision]"

El extra es separado porque las ruedas CUDA añaden varios gigabytes a una instalación que la mayoría de las herramientas nunca tocan. Instale primero la compilación de PyTorch apropiada para el controlador CUDA de la máquina si la rueda predeterminada no coincide; get_capabilities reporta el backend que está realmente activo.

requirements.txt todavía lista las dependencias base para cualquiera que instale sin los metadatos del paquete.

Configuración de MCP

Apunte el cliente MCP al punto de entrada del repositorio usando el ejecutable de Python del entorno virtual:

{
  "mcpServers": {
    "SolidworksMCP": {
      "command": "C:\\path\\to\\SolidworksMCP\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\SolidworksMCP\\solidworks_mcp_server.py"
      ]
    }
  }
}

Inicie SOLIDWORKS, reinicie o reconecte el cliente MCP, luego llame a get_capabilities y get_environment_status antes de una operación de modelado sustancial.

Identificadores de compatibilidad estables

SolidworksMCP es el nombre público del proyecto y del apretón de manos de MCP. El paquete de Python sigue siendo solidworks_mcp, el espacio de nombres de herramientas configurado sigue siendo solidworks, y los esquemas de artefactos existentes conservan sus identificadores solidworks-mcp/.... Esos nombres internos son contratos de compatibilidad y no se renombran intencionalmente.

Familias de operaciones

El servidor expone tanto pequeñas operaciones nativas como flujos de trabajo verificados de nivel superior. Las familias importantes incluyen:

• documentos y entorno: crear/abrir/guardar/cerrar, capacidades, métricas de sesión, inspección de estado modal, recuperación;

• croquis: planos estándar, caras planas, contornos exactos en coordenadas de modelo, dibujo de primitivas, croquis paramétricos, cotas, restricciones, ecuaciones;

• funciones: extruir/cortar verificado, revolución, barrido, redondeo, chaflán, cáscara, simetrías, patrones, ejes y planos de referencia;

• cuerpos: visibilidad, nombre, apariencia, volumen, holgura, interferencia, flujos de trabajo de inserción multicuerpo;

• verificación: sondas de rayo/sección, topología de croquis, exportación de geometría nativa, comparaciones de croquis a croquis e imágenes calibradas, siluetas de cuerpo;

• vectorización: modos seleccionables de silueta/región/arte lineal, segmentación profunda, aproximación controlable, compromiso CAD y verificación de ráster inverso;

• dibujos: láminas, vistas de modelo y estándar, vistas de sección y detalle, anotaciones de modelo, cotas manuales, notas, globos, marcas de centro, tablas de lista de materiales;

• ensamblajes: inserción y eliminación de componentes, relaciones de posición, reemplazo, supresión, patrones de componentes, vistas explosionadas, comprobaciones de interferencia;

• chapa metálica: brida base, conversión de sólidos importados, bridas de borde, estado de patrón plano, exportación de patrón plano DXF/DWG, parámetros de chapa metálica;

• salida de fabricación: exportación de paquete de una sola llamada de STEP, DXF y PDF con un manifiesto, para una pieza o un ensamblaje completo;

• documentos en disco: búsqueda de archivos por nombre y tipo, referencias salientes con detección de archivos faltantes y uso en un árbol de carpetas;

• configuraciones y parámetros: configuraciones, propiedades personalizadas, materiales, propiedades de masa, cotas, ecuaciones;

• orquestación: transacciones, planes CAD declarativos, primitivas semánticas, sincronización de grafo de modelo, paquetes de exportación atómicos.

Use el descubrimiento de herramientas de MCP para el esquema en vivo autoritativo. Las descripciones de herramientas y get_capabilities están versionadas con el servidor.

Reglas de seguridad

• Proporcione una save_path absoluta antes de la primera mutación de un documento no guardado, o opte explícitamente por trabajo desechable con allow_unsaved_document=true.

• Trate success como evidencia de ejecución. Verifique topología, recuento de cuerpos, cajas delimitadoras, volumen, tolerancias y un artefacto independiente legible.

• Use scope_bodies y expected_merge_bodies para cortes y salientes multicuerpo.

• No confirme automáticamente diálogos desconocidos. Solo el diálogo Modify de cota reconocido y de alcance de operación puede ser manejado por el vigilante.

• Las coordenadas nativas de las herramientas MCP usan la unidad de usuario declarada, normalmente milímetros. Las coordenadas COM crudas de SOLIDWORKS usan metros.

• No invoque un Ctrl+8 ciego después de operaciones de croquis. La versión 6.5.31 ya aplica y verifica la orientación estable lateral/superior y el ajuste de la geometría de trabajo.

Modelos de vectorización

Los puntos de control deterministas de arte lineal se encuentran en solidworks_mcp/models/lineart/ y se almacenan con Git LFS:

• dexed_biped_v2.pt

• teed_biped_5.pt

Su origen y los avisos de licencia están documentados en solidworks_mcp/models/lineart/LICENSES.md. Un clon que contiene pequeños archivos de puntero LFS en lugar de los objetos binarios está incompleto; ejecuta git lfs pull antes de iniciar el servidor.

SOLIDWORKS Autotrace/Picture to Sketch es una función interactiva de PropertyManager y no tiene un punto de entrada compatible con la API pública. Por lo tanto, este servidor utiliza sus propios pipelines deterministas de segmentación y de arte lineal.

Configuración

La configuración de ejecución predeterminada se almacena en solidworks_mcp/config.json. Los ajustes específicos de la máquina o sensibles que reemplacen la configuración deben guardarse en config.local.json; Git ignora ese archivo.

Entre los valores predeterminados más destacados se incluyen:

• `descubrimiento' automático del ejecutable y las plantillas de SOLIDWORKS;

• `milímetros' como unidad del usuario;

• `protección' del diálogo de cotas con ámbito de operación;

• `límites' acotados de transacciones/tiempo de ejecución;

• `gestión' automática del directorio de puntos de control;

• `registro' de archivos a nivel INFO.

Los valores relativos de log_file se escriben en %LOCALAPPDATA%\SolidworksMCP\, no en el directorio de trabajo del repositorio. También se admite una ruta absoluta en config.json.

Pruebas

El repositorio contiene la suite determinista de pruebas unitarias y de regresión:

python -m unittest discover -s tests -p "test_*.py"

La suite supera 382 pruebas. Estas pruebas no sustituyen la aceptación en vivo del comportamiento COM: validar otra versión principal de SOLIDWORKS también debería cubrir planos estándar, caras planas, activación de croquis existentes, recuperación de vistas, operaciones, transacciones, vectorización y exportación.

Estructura del proyecto

SolidworksMCP/
|-- solidworks_mcp_server.py       MCP stdio entry point
|-- requirements.txt
|-- LICENSE
|-- solidworks_mcp/
|   |-- server.py                  MCP dispatch and handlers
|   |-- schemas/                   tool schemas, grouped by family
|   |-- tool_registry.py           high-level tool metadata
|   |-- vector_worker.py           isolated scientific worker
|   |-- config.py / config.json
|   |-- constants.py
|   |-- automation/                SOLIDWORKS COM implementation
|   |-- models/lineart/            Git-LFS checkpoints and licenses
|   `-- utils/
`-- tests/
    `-- test_v6.py                 unit and regression suite

Los registros de ejecución, las cachés, los ajustes locales del cliente, los puntos de control, los informes generados, los artefactos de aceptación y las comprobaciones manuales se excluyen intencionadamente del repositorio.

Licencia

El servidor se distribuye bajo la Licencia MIT; consulte LICENSE. Los avisos de los modelos empaquetados se conservan en por separado en solidworks_mcp/models/lineart/LICENSES.md.

Este repositorio es una bifurcación de alisamsam/Solidworks-MCP por Samsa Ali Baig. Se conserva el aviso de copyright original y las modificaciones realizadas aquí se liberan bajo la misma Licencia MIT. LICENSE recoge a ambos titulares de los derechos de autor y resume lo que añade esta bifurcación.