Civil 3D MCP

Servidor Civil 3D MCP

Un servidor MCP (Model Context Protocol) que permite a los asistentes de IA (Claude, Cline, etc.) interactuar con Autodesk Civil 3D mediante lenguaje natural.

Arquitectura

┌─────────────────┐     stdio      ┌──────────────────┐     TCP/JSON-RPC    ┌──────────────────┐
│   AI Assistant   │ ◄────────────► │  MCP Server (TS) │ ◄──────────────────► │  Civil 3D Plugin │
│ (Claude, Cline)  │               │   Node.js         │     port 8080       │   (.NET 8.0 C#)  │
└─────────────────┘               └──────────────────┘                      └──────────────────┘
                                                                                     │
                                                                              Civil 3D API
                                                                            (Surfaces, Alignments,
                                                                             Points, Corridors...)

El sistema tiene dos componentes:

1. Servidor MCP (TypeScript/Node.js) — Se comunica con los asistentes de IA mediante el protocolo MCP
2. Plugin Civil 3D (C# .NET 8.0) — Se ejecuta dentro de Civil 3D y ejecuta comandos de API

Herramientas Disponibles

Herramienta	Acciones	Descripción
civil3d_health	health	Comprobar la conectividad del plugin
civil3d_drawing	info, settings, save, undo, redo, list_object_types, get_selected	Operaciones de dibujo
civil3d_surface	list, get, get_elevation, get_statistics, create, delete, add_points, add_breakline, add_boundary, extract_contours, compute_volume	Gestión de superficies
civil3d_alignment	list, get, create, delete, station_to_point, point_to_station	Operaciones de alineaciones
civil3d_profile	list, get, get_elevation, create_from_surface, create_layout, delete	Gestión de perfiles
civil3d_corridor	list, get, rebuild, get_surfaces, get_feature_lines, compute_volumes	Operaciones de corredores
civil3d_pipe	list_networks, get_network, get_pipe, get_structure, create_network, add_pipe, add_structure, check_interference	Redes de tuberías
civil3d_point	list, get, create, delete, list_groups, import	Puntos COGO
civil3d_geometry	create_line, create_polyline, create_3d_polyline, create_text, create_mtext	Geometría básica de AutoCAD

Configuración

1. Compilar el Servidor MCP

npm install npm run build

2. Compilar el Plugin Civil 3D

1. Copie los DLL requeridos desde su instalación de Civil 3D a C_References/ (consulte C_References/README.md)
2. Compile el plugin:

cd plugin/Civil3dMcpPlugin dotnet build

3. Cargar el Plugin en Civil 3D

1. Abra Civil 3D 2025+
2. Escriba NETLOAD en la línea de comandos
3. Navegue hasta plugin/Civil3dMcpPlugin/bin/Debug/net8.0-windows/Civil3dMcpPlugin.dll
4. El plugin se inicia automáticamente. Use C3DMCPSTATUS para verificarlo.

4. Configurar Su Asistente de IA

Claude Desktop — Agregue a claude_desktop_config.json:

{ "mcpServers": { "civil3d": { "command": "node", "args": ["/path/to/civil3d-mcp/build/index.js"] } } }

Variables de Entorno

Variable	Predeterminado	Descripción
CIVIL3D_HOST	localhost	Host del plugin Civil 3D
CIVIL3D_PORT	8080	Puerto del plugin Civil 3D
CIVIL3D_CONNECT_TIMEOUT	5000	Tiempo de espera de conexión (ms)
CIVIL3D_COMMAND_TIMEOUT	120000	Tiempo de espera de ejecución (ms)
LOG_LEVEL	info	Nivel de registro (debug, info, warn, error)

Comandos del Plugin

Comando	Descripción
C3DMCPSTART	Iniciar el listener TCP
C3DMCPSTOP	Detener el listener TCP
C3DMCPSTATUS	Verificar el estado del listener

Licencia

MIT