Civil 3D MCP

Servidor MCP de Civil 3D

Un servidor MCP (Protocolo de Contexto de Modelo) 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. Complemento de 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	Verificar conectividad del complemento
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 Complemento de 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 complemento:

cd plugin/Civil3dMcpPlugin
dotnet build

3. Cargar el Complemento 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 complemento se inicia automáticamente. Use C3DMCPSTATUS para verificar.

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 complemento de Civil 3D
CIVIL3D_PORT	8080	Puerto del complemento de Civil 3D
CIVIL3D_CONNECT_TIMEOUT	5000	Tiempo de espera de conexión (ms)
CIVIL3D_COMMAND_TIMEOUT	120000	Tiempo de espera de ejecución de comandos (ms)
LOG_LEVEL	info	Nivel de registro (debug, info, warn, error)

Comandos del Complemento

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

Licencia

MIT