Civil3 D MCP

Civil3D-MCP Server

Connect Claude, Cursor, Cline, and other MCP clients directly to a live Autodesk Civil 3D drawing.

Node.js MCP server + native Civil 3D plugin + workflow automation for grading, hydrology, plan production, QC, and data shortcuts.

](https://nodejs.org)     

Quick Start • Installation • Deployment • Tool Reference

______________________________________________________________________

这是什么？

Civil3D MCP 将人工智能助手（Claude、Cline、Cursor等）连接到 实时、开放的Civil 3D绘图 使用 模型上下文协议给克劳德你的设计简报——它会读取你的图纸，运行计算，并实时进行更改。

AI Client  ↔  civil3d-mcp (Node.js / stdio)  ↔  HTTP :8765  ↔  Civil3D-MCP-Plugin.dll (inside Civil 3D)

这是 MCP服务器 （TypeScript）。您还需要 Civil 3D。NET插件 --看 安装.

最近发生了什么变化

• 本地工作流处理程序现在涵盖了主要的质量控制、分级、水文、计划生产和数据快捷流程，而不仅仅依赖于客户端编排。
• Claude Code现在可以使用单个项目范围的命令进行注册，该命令安装依赖项、构建Node服务器并编写仓库 .mcp.json 进入。
• 存储库生成的工具库存已上线 output_repo_tools，使审计已经实施的内容与路线图上仍然存在的内容变得更加容易。

______________________________________________________________________

快速开始

如果你想在Windows上从克隆到工作的Claude+Civil 3D安装程序的最快路径：

1. 克隆并构建节点端：

   git clone https://github.com/Sacred-G/Civil3D-mcp.git
   cd Civil3D-mcp
   npm install
   npm run build

1. 建造和 NETLOAD Civil 3D插件：

   dotnet build .\Civil3D-MCP-Plugin\Civil3DMcpPlugin.csproj -c Release

1. 为此仓库注册Claude代码：

   npm run claude:add

1. 打开Civil 3D，加载插件，开始请求实际工作：

- “在设计开始之前审核此图纸。” - “从该要素线创建放坡曲面。” - “划定流域并估算径流。” - “将平面图/剖面图发布为PDF。”

______________________________________________________________________

特性

• 180+MCP工具 涵盖完整的Civil 3D设计工作流程
• 本机工作流执行 用于走廊质量控制、地表比较、项目启动、分级转换、计划发布、数据快捷方式和水文管道
• 完整的道路设计管道 --路线、纵断面、走廊、横断面、超高
• 表面分析 --高程带、坡度分布、坡向、分水岭、挖方/填方量
• 管道和压力网络 设计、验证和水力分析
• 计划生产 --图纸集、平面图/剖面图、PDF导出
• QC检查 --路线、纵断面、道路、曲面、管网、绘图标准
• 数量起飞 --土方工程、走廊材料、管道长度、地块面积、CSV导出
• 成本估算 --付款项目、材料成本、施工估算
• 水文学 --流路追踪、流域划定、推理径流法、集流时间
• 评分 --要素线、放坡组、放坡标准、曲面生成
• COGO/测量 --反演、导线测量、曲线求解、测量图形、LandXML导入
• 风暴与卫生分析（SSA） 集成和滞留池尺寸
• 交叉口设计 以及走廊目标映射
• 视距 计算和AASHTO停车视距检查
• 组装/子装配 创建和编辑

______________________________________________________________________

建筑

flowchart LR
    Client["AI Client\n(Claude / Cline / Cursor)"] -->|"MCP stdio"| Server["civil3d-mcp\nNode.js MCP Server"]
    Server -->|"POST :8765/execute"| Plugin

    subgraph Civil3D ["Autodesk Civil 3D"]
        Plugin["Civil3D-MCP-Plugin.dll\nHTTP Listener"]
        Queue["ConcurrentQueue\n(thread-safe)"]
        Idle["Application.Idle\n(main thread)"]
        Router["CommandRouter"]
        API["Civil 3D .NET API"]

        Plugin --> Queue --> Idle --> Router --> API
    end

为什么 Application.Idle? Civil 3D（如Blender）需要在主线程上执行所有数据库操作。该插件将传入的HTTP请求排队，并在主线程的空闲事件上清空队列，从而提供对Civil 3D的完全、安全的访问。NET API。

______________________________________________________________________

需求

______________________________________________________________________

安装

1--构建MCP服务器（TypeScript）

git clone https://github.com/Sacred-G/Civil3D-mcp.git
cd Civil3D-mcp
npm install
npm run build

1.5--单行克劳德代码设置

从Windows上的repo根目录，此项目范围的命令将MCP服务器添加到Claude Code并创建repo .mcp.json 自动输入：

claude mcp add --scope project --transport stdio civil3d-mcp -- powershell -NoProfile -ExecutionPolicy Bypass -File "$PWD\scripts\claude-bootstrap-and-run.ps1"

注册的启动器将在Claude第一次启动时自动安装npm依赖项并构建Node服务器。

如果你想要一个包装器来完成安装、构建和 claude mcp add 立即为您踏出一步，运行：

npm run claude:add

有用的变体：

npm run claude:add:user
npm run claude:print-add

2--构建并加载C#插件

先决条件： Civil 3D 2023+。NET 8 SDK和本地Civil 3D API程序集复制到 C_References/

dotnet build .\Civil3D-MCP-Plugin\Civil3DMcpPlugin.csproj -c Release
# Output: Civil3D-MCP-Plugin\bin\Release\net8.0-windows\Civil3DMcpPlugin.dll

插件项目解析来自以下位置的Autodesk引用 C_References。至少，请确保这些本地DLL存在：

accoremgd.dll
AcDbMgd.dll
acmgd.dll
AecBaseMgd.dll
AeccDbMgd.dll

加载到Civil 3D中：

加载后，Civil 3D命令行中有三个命令可用：

3--配置您的AI客户端

建议用于Claude Code

npm run claude:add

该命令在Claude Code中注册引导启动器，并保持仓库自包含。使用 npm run claude:print-add 如果你想检查确切的 claude mcp add 命令，无需修改配置。

克劳德桌面版 — claude_desktop_config.json:

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

克劳德代码 --通过CLI添加：

claude mcp add --scope project --transport stdio civil3d-mcp -- powershell -NoProfile -ExecutionPolicy Bypass -File "$PWD\scripts\claude-bootstrap-and-run.ps1"

重新启动客户端。当你看到 锤图标，MCP连接处于活动状态。

关于Docker、npm发布、环境变量和备用部署路径，请参阅 文档/部署.md.

______________________________________________________________________

对话示例

*“此图中有哪些对齐方式，每条对齐方式有多长？”* → civil3d_alignment → 返回名称、站范围、长度

*“对走廊进行全面的质量控制检查，并给我一份报告。”* → civil3d_workflow_corridor_qc_report → 检查目标、区域、重建错误、导出报告

*从坐标（50003200）追踪水流路径，并使用推理计算法估算峰值径流* → civil3d_hydrology_watershed_runoff_workflow → 描绘流域，计算Q=CiA

*“创建对齐‘主线’的平面图/剖面图集，并导出为PDF。”* → civil3d_plan_profile_sheet_create → civil3d_workflow_plan_production_publish

*“确定10年一遇暴雨的雨水排放网络尺寸，并检查所有管道速度。”* → civil3d_pipe_network_size → civil3d_pipe_network_hydraulics

*“计算现有地面和拟建表面之间的挖方/填方体积。”* → civil3d_surface_volume_calculate → civil3d_surface_volume_report

______________________________________________________________________

工具参考（180多种工具）

Drawing Info & Context (7 tools)

Drawing Primitives (6 tools)

Alignment (10 tools)

Profile (10 tools)

Superelevation (4 tools)

Surface (15 tools)

Corridor (6 tools)

Sections & Section Views (6 tools)

Intersection Design (3 tools)

Grading & Feature Lines (14 tools)

Points & Point Groups (6 tools)

COGO & Survey (9 tools)

Pipe Networks — Gravity (3 tools)

Pressure Networks (15 tools)

Plan Production / Sheets (12 tools)

QC Checks (8 tools)

Workflow Automation (14 tools)

Quantity Takeoff (10 tools)

Hydrology (7 tools)

Pipe Hydraulics (3 tools)

Pipe Design Automation (2 tools)

Assembly Creation (3 tools)

Sight Distance (2 tools)

Detention & Stormwater (2 tools)

Slope Analysis (2 tools)

Cost Estimation (2 tools)

Survey Processing (4 tools)

Data Shortcuts (4 tools)

Parcel Editing (4 tools)

Standards & Miscellaneous (7 tools)

______________________________________________________________________

Civil 3D版本兼容性

有关启动套件和自动加载注册表的详细信息，请使用中的版本特定指南 文档/部署.md.

______________________________________________________________________

故障排除

“无法连接到Civil 3D插件”

• Civil 3D必须打开并加载图形
• 类型 MCPSTATUS 在Civil 3D中--确认服务器显示为在端口8765上运行
• 检查Windows防火墙是否未阻止 localhost:8765

“没有活动文档”

• 打开A .dwg 在调用任何工具之前，请先在Civil 3D中创建文件

“找不到对齐/表面”

• 名称不区分大小写，但必须完全匹配
• 首先使用相应的列表工具（例如。 civil3d_alignment → list 行动）

插件无法加载

• 验证DLL的目标是正确的Civil 3D版本
• 确保Civil 3D和Visual Studio以同一Windows用户身份运行（无标高不匹配）
• 检查传递给的DLL路径 NETLOAD 没有空格或特殊字符

______________________________________________________________________

文档

______________________________________________________________________

贡献

欢迎拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/my-tool)
3. 提交您的更改(git commit -m 'Add civil3d_my_tool')
4. 推到分支(git push origin feature/my-tool)
5. 打开拉取请求

______________________________________________________________________

许可证

国际学生中心 --史蒂文·布丁