MCP-сервер, который позволяет ИИ-ассистентам ** писать и выполнять код C#** непосредственно в Autodesk Civil 3D. Вместо фиксированных инструментов ИИ генерирует код, который работает с полным доступом к API.

Архитектура

##3 Метаинструменты

| Инструмент | Цель | Безопасность [скрыто] [скрыто] [скрыто] [скрыто] [скрыто] | civil3d_execute | Исполнить код C# с доступом write (совершенная транзакция) | ️ Изменяет рисунок | |civil3d_query | Исполнить код C# только для чтения (без обязательств) | Без побочных эффектов | | civil3d_skills | Шаблоны навыков просмотра/поиска/чтения кода | ✅ Только метаданные |

###Как это работает

1. **AI читает навык ** → Получает задокументированный шаблон кода C#
2. **AI адаптирует код ** → Заполняет параметры, комбинирует шаблоны
3. **AI отправляет код ** → Via civil3d_execute или civil3d_query
4. **Roslyn компилирует + запускает ** → Inside Civil 3D с полным доступом к API
5. Результаты возвращаются как JSON

Пример взаимодействия

Библиотека навыков

Навыки документированы шаблоны кода C# в skills/:

###Сценаристский мир

Код, выполненный через civil3d_execute или civil3d_query, имеет доступ:

| Глобальный | Тип | Описание

Document | Document | Документ Active AutoCAD |

Civil 3D MCP Server — Code Execution Architecture

An MCP server that enables AI assistants to write and execute C# code directly inside Autodesk Civil 3D. Instead of fixed tools, the AI generates code that runs with full API access.

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐     TCP/JSON-RPC    ┌──────────────────┐
│   AI Assistant   │ ◄────────────► │  MCP Server (TS) │ ◄──────────────────► │  Civil 3D Plugin │
│ (Claude, Cline)  │               │   3 meta-tools    │     port 8080       │  Roslyn Engine   │
└─────────────────┘               └──────────────────┘                      └──────────────────┘
                                         │                                         │
                                    Skills Library                           C# Code Execution
                                   (.skill.md files)                      (full Civil 3D API)

3 Meta-Tools

How It Works

1. AI reads a skill → Gets a documented C# code template
2. AI adapts the code → Fills in parameters, combines patterns
3. AI sends code → Via civil3d_execute or civil3d_query
4. Roslyn compiles + runs → Inside Civil 3D with full API access
5. Results return as JSON → Back to the AI

Example Interaction

User: "What surfaces are in my drawing?"

AI: Uses civil3d_query with:
  var surfaces = new List();
  foreach (ObjectId id in CivilDoc.GetSurfaceIds()) {
    var s = Transaction.GetObject(id, OpenMode.ForRead) as TinSurface;
    surfaces.Add(new { s.Name, s.Layer });
  }
  return surfaces;

Result: [{ "Name": "EG", "Layer": "C-TOPO-EG" }, ...]

Skills Library

Skills are documented C# code templates in skills/:

skills/
├── surfaces/           # Surface operations
├── alignments/         # Alignment + station/offset
├── points/             # COGO points
├── geometry/           # Lines, polylines, text
├── drawing/            # Drawing info
└── workflows/          # Complex multi-object operations

Script Globals

Code executed via civil3d_execute or civil3d_query has access to:

All Civil 3D namespaces are auto-imported.

Setup

1. Build MCP Server

npm install && npm run build

2. Build Plugin