civil3d-mcp

English | 简体中文

Description

civil3d-mcp allows you to interact with Autodesk Civil 3D using the MCP protocol through MCP-supported clients (such as Claude, Cline, etc.).

This project is the server side (providing Tools to AI), and you need to use a Civil 3D MCP plugin (driving Civil 3D) in conjunction.

Join Discord | QQ Group

Features

• Allow AI to get data from the Civil 3D project
• Allow AI to drive Civil 3D to create, modify, and delete elements
• Send AI-generated code to Civil 3D to execute (may not be successful, successful rate is higher in some simple scenarios with clear requirements)

Requirements

• nodejs 18+

Complete installation environment still needs to consider the needs of the Civil 3D MCP plugin, please refer to its documentation.

Installation

1. Build local MCP service

Install dependencies

npm install

Build

npm run build

2. Client configuration

Claude client

Claude client -> Settings > Developer > Edit Config > claude_desktop_config.json

{
    "mcpServers": {
        "civil3d-mcp": {
            "command": "node",
            "args": ["<path to the built file>\\build\\index.js"]
        }
    }
}

Restart the Claude client. When you see the hammer icon, it means the connection to the MCP service is normal. (example shows Civil 3D, will be Civil 3D)

Framework

flowchart LR
	CladueDesktop --> civil3d-mcp --> SocketService--commandName-->CommandlSet--command-->CommandExecute
	CommandManager --> CommandlSet
	CommandExecute --executeResult--> SocketService
	CommandProject1 --> CommandManager
	CommandProject2 --> CommandManager
	CommandProject... --> CommandManager
	subgraph ide1 [MCPClient]
	CladueDesktop
	end
	subgraph ide2 [MCPServer]
	civil3d-mcp
	end
	subgraph ide3 [Civil 3D]
			subgraph ide3.1 [civil3d-mcp-plugin]
				SocketService
				CommandlSet
				CommandManager
				CommandExecute
			end
	end

Supported Tools

Name	Description
get_drawing_info	Retrieves basic information about the active Civil 3D drawing.
list_civil_object_types	Lists major Civil 3D object types available or present in the current drawing (e.g., Alignments, Surfaces).
get_selected_civil_objects_info	Gets basic properties of currently selected Civil 3D objects. Can limit the number of returned objects.
create_cogo_point	Creates a new COGO (Coordinate Geometry) point in the Civil 3D drawing.
create_line_segment	Creates a simple line segment in the Civil 3D drawing.