How sacred-g/civil3d-mcp works
Civil3D-MCP is an MCP server plus a native Civil 3D plugin: an AI client submits tool requests, the Node server routes and executes them over JSON-RPC/TCP, and the plugin operates on the live drawing. The map includes orchestration, domain tools, CAD execution, help, standards, and approval capabilities documented in the README. Several domain implementations and registrations are unsampled, so their documented capabilities are represented at directory level and uncertain internal call links are omitted.
Main entry points: civil3d_orchestrate.ts Tool Orchestrator · index.ts MCP Server · domains Civil Design Tools · ConnectionManager.ts Connection Manager
Components 25
Client Interfaces
- MCP Server
src/index.ts - HTTP Bridge
src/httpBridge.ts
Request Orchestration
- Tool Orchestrator
src/tools/civil3d_orchestrate.ts - Intent Router
src/orchestration/IntentRouter.ts - Workflow Planner
src/orchestration/WorkflowPlanner.ts - Project Context
src/orchestration/ProjectContextService.ts - Selection Resolver
src/orchestration/SelectionResolver.ts - Tool Registry
src/tools/toolHandlerRegistry.ts - Approval Policy
src/tools/approvalPolicy.ts
Civil Design Domains
- Civil Design Tools
src/tools/domains - CAD Command Handlers
Civil3D-MCP-Plugin
Execution and State
- Domain Runtime
src/tools/domainRuntime.ts - Connection Manager
src/utils/ConnectionManager.ts - TCP JSON-RPC Client
src/utils/SocketClient.ts - Civil 3D Plugin
Civil3D-MCP-Plugin/PluginEntry.cs - Command Dispatcher
Civil3D-MCP-Plugin/CommandDispatcher.cs
Help and Standards
- Help Tools
src/tools/domains/docsDomain.ts - Help Search
src/help/helpIndex.ts - Help Parser
src/help/helpParser.ts - Framework Standards
src/standards/FrameworkStandardsService.ts - Tutorial Videos
src/help/videoCatalog.ts
Other components
- MCP Client
- HTTP Client
- Live Drawing
- Local Autodesk Help
Connections 25
- MCP Client → MCP Server: MCP requests
- HTTP Client → HTTP Bridge: HTTP requests
- MCP Server → HTTP Bridge: starts
- HTTP Bridge → Tool Registry: invokes tools
- MCP Server → Tool Orchestrator: registers tool
- Tool Orchestrator → Intent Router: routes intent
- Tool Orchestrator → Workflow Planner: plans workflow
- Tool Orchestrator → Project Context: loads context
- Tool Orchestrator → Selection Resolver: resolves selection
- Tool Orchestrator → Tool Registry: executes tool
- MCP Server → Civil Design Tools: registers domains
- Civil Design Tools → Domain Runtime: uses runtime
- Domain Runtime → Connection Manager: dispatches commands
- Connection Manager → TCP JSON-RPC Client: sends RPC
- TCP JSON-RPC Client → Civil 3D Plugin: JSON-RPC/TCP
- Civil 3D Plugin → Command Dispatcher: dispatches methods
- Command Dispatcher → CAD Command Handlers: invokes handlers
- CAD Command Handlers → Live Drawing: reads and modifies
- Connection Manager → Project Context: serves context request
- Civil Design Tools → Approval Policy: guards mutations
- Help Tools → Help Search: searches topics
- Help Search → Help Parser: parses topics
- Help Parser → Local Autodesk Help: reads local files
- Help Tools → Tutorial Videos: finds videos
- Civil Design Tools → Framework Standards: looks up standards