Civil 3D MCP

Servidor MCP Civil 3D

Um servidor MCP (Model Context Protocol) que permite que assistentes de IA (Claude, Cline, etc.) interajam com o Autodesk Civil 3D por meio de linguagem natural.

Arquitetura

┌─────────────────┐     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...)

O sistema possui dois componentes:

1. Servidor MCP (TypeScript/Node.js) — Comunica-se com assistentes de IA via protocolo MCP
2. Plugin Civil 3D (C# .NET 8.0) — Executa dentro do Civil 3D e executa comandos da API

Ferramentas Disponíveis

Ferramenta	Ações	Descrição
civil3d_health	health	Verifica a conectividade do plugin
civil3d_drawing	info, settings, save, undo, redo, list_object_types, get_selected	Operações de desenho
civil3d_surface	list, get, get_elevation, get_statistics, create, delete, add_points, add_breakline, add_boundary, extract_contours, compute_volume	Gerenciamento de superfícies
civil3d_alignment	list, get, create, delete, station_to_point, point_to_station	Operações de alinhamento
civil3d_profile	list, get, get_elevation, create_from_surface, create_layout, delete	Gerenciamento de perfis
civil3d_corridor	list, get, rebuild, get_surfaces, get_feature_lines, compute_volumes	Operações de corredores
civil3d_pipe	list_networks, get_network, get_pipe, get_structure, create_network, add_pipe, add_structure, check_interference	Redes de tubulação
civil3d_point	list, get, create, delete, list_groups, import	Pontos COGO
civil3d_geometry	create_line, create_polyline, create_3d_polyline, create_text, create_mtext	Geometria básica do AutoCAD

Configuração

1. Compilar o Servidor MCP

npm install npm run build

2. Compilar o Plugin Civil 3D

1. Copie as DLLs necessárias da sua instalação do Civil 3D para C_References/ (veja C_References/README.md)
2. Compile o plugin:

cd plugin/Civil3dMcpPlugin dotnet build

3. Carregar o Plugin no Civil 3D

1. Abra o Civil 3D 2025+
2. Digite NETLOAD na linha de comando
3. Navegue até plugin/Civil3dMcpPlugin/bin/Debug/net8.0-windows/Civil3dMcpPlugin.dll
4. O plugin inicia automaticamente. Use C3DMCPSTATUS para verificar.

4. Configurar Seu Assistente de IA

Claude Desktop — Adicione em claude_desktop_config.json:

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

Variáveis de Ambiente

Variável	Padrão	Descrição
CIVIL3D_HOST	localhost	Host do plugin Civil 3D
CIVIL3D_PORT	8080	Porta do plugin Civil 3D
CIVIL3D_CONNECT_TIMEOUT	5000	Tempo limite de conexão (ms)
CIVIL3D_COMMAND_TIMEOUT	120000	Tempo limite de execução de comando (ms)
LOG_LEVEL	info	Nível de log (debug, info, warn, error)

Comandos do Plugin

Comando	Descrição
C3DMCPSTART	Inicia o listener TCP
C3DMCPSTOP	Para o listener TCP
C3DMCPSTATUS	Verifica o status do listener

Licença

MIT