🏗 nanoCAD MCP Server

MCP-сервер для автоматизации nanoCAD 26 — 183 инструмента для 2D/3D черчения, инженерных символов, размеров, листового металла, сборок и MultiCAD API.

Работает через протокол Model Context Protocol (MCP) с любыми MCP-клиентами: opencode, Claude Desktop, Cursor и др.

AI Agent (opencode / Claude / Cursor)
     │
     │ MCP (stdio / SSE)
     ▼
Python MCP Server (183 инструмента)
     │
     │ HTTP REST (localhost:5080)
     ▼
.NET Engine Plugin (внутри nanoCAD 26)
     │
     │ Multicad.* API / Teigha
     ▼
nanoCAD — чертёж

✨ Возможности

| Категория | Инструментов | Примеры | |-----------|:-----------:|---------| | 2D примитивы | 16 | линия, окружность, дуга, сплайн, эллипс, геликс | | 3D тела | 16 | box, сфера, цилиндр, конус, тор, клин, пирамида | | Булевы операции | 3 | объединение, вычитание, пересечение | | 3D операции | 7 | выдавливание, вращение, сдвиг, лофтинг, скругление, фаска | | Размеры | 8 | линейный, радиальный, диаметральный, угловой, ординатный | | Инженерные символы | 9 | шероховатость (ГОСТ), допуски, базы, сварка, выноски | | Слои | 11 | создание, изоляция, заморозка, удаление | | Блоки | 6 | создание, вставка, расчленение, удаление | | Таблицы | 4 | создание, редактирование ячеек | | Штриховка | 4 | штриховка, градиент | | Трансформации | 7 | перемещение, поворот, масштаб, зеркало | | 3D трансформации | 6 | 3D массив, выравнивание, 3D зеркало | | 2D ограничения | 12 | параллельность, перпендикулярность, касание, концентричность | | Сборки | 5 | сопряжение, вставка детали, симметрия | | Листовой металл | 5 | базовая пластина, отбортовка, гибка, развёртка | | 3D особенности | 13 | отверстия, оболочка, эскизы, выдавливание, вращение | | Документы | 16 | создание, открытие, сохранение, экспорт PDF/DWG/DXF/STEP/STL/IFC | | Система | 6 | переменные, шрифты, типы линий, произвольные команды | | Измерения | 6 | расстояние, угол, площадь, информация об объекте | | NURBS / IFC | 5 | NURBS-кривые, поверхности, IFC импорт | | MultiCAD API | 12 | оси, помещения, параметрические объекты, реакторы | | Прочее | 12 | сетка, выборка, обрезка, удлинение, смещение, вьюпорт, рендер | | ИТОГО | 183 | |

🚀 Быстрый старт

1. Установка

# Клонировать репозиторий
git clone https://github.com/nanoCAD/nanoCAD-MCP.git
cd nanoCAD-MCP

# Установить Python-пакет
cd server
pip install -e .
pip install -e ".[sse,dev]"   # для SSE транспорта и разработки

2. Установка .NET плагина

Вариант А (рекомендуется): В репозитории уже есть собранный плагин — engine\dist\CadEngine.Plugin.dll (Release, 254 KB). Сборка не требуется.

Вариант Б: Собрать из исходников:

dotnet build engine\CadEngine.Plugin\CadEngine.Plugin.csproj --configuration Release

3. Подключение плагина к nanoCAD

Добавьте путь к DLL в файл nCad.ini (раздел [\NetModules]):

F:\full\path\to\nanoCAD-MCP\engine\CadEngine.Plugin\bin\Debug\CadEngine.Plugin.dll

4. Запуск

# Терминал 1: Запустите nanoCAD 26 (с загруженным плагином)

# Терминал 2: Запустите MCP-сервер
cd server
py -m src.presentation.server

5. Подключение клиента

opencode (opencode.json):

{
  "mcp": {
    "nanoCAD": {
      "command": "py",
      "args": ["-m", "src.presentation.server"],
      "cwd": "F:\\nanoCAD\\server"
    }
  }
}

Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "nanoCAD": {
      "command": "py",
      "args": ["-m", "src.presentation.server"],
      "cwd": "F:\\nanoCAD\\server"
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "nanoCAD": {
      "command": "py",
      "args": ["-m", "src.presentation.server"],
      "cwd": "F:\\nanoCAD\\server"
    }
  }
}

6. Проверка

# Проверить, что сервер отвечает
Invoke-RestMethod -Uri "http://localhost:5080/api/system/health"

# Запустить демо-скрипт (создаёт тестовый чертёж)
py server\scripts\demo_lite.py

🔧 Команды

# Запуск сервера
py -m src.presentation.server
py -m src.presentation.server --transport sse --port 8081   # удалённый доступ

# Тесты
py -m pytest server/tests/ -v                                    # все
py -m pytest server/tests/unit/ -v --cov=src                     # unit + coverage
py -m pytest server/tests/integration/ -v                        # интеграционные

# Линтинг
py -m ruff check server/src/
py -m ruff format server/src/
py -m mypy server/src/

# Демо-скрипты
py server/scripts/demo_lite.py
py server/scripts/demo_engineering_project.py
py server/scripts/demo_bracket.py

🧪 Тестовый статус

| Вид тестов | Количество | Статус | |-----------|:----------:|:------:| | Unit-тесты (mocked HTTP) | 777 | ✅ Pass | | Интеграционные (живой nanoCAD) | 189 (+33 skipped) | ✅ Pass | | MCP server (полный chain) | 51 | ✅ Pass | | Типы (mypy --strict) | 17 файлов | ✅ Clean | | Линтер (ruff) | — | ✅ Clean | | Покрытие Python-кода | 81% | ✅ |

🔌 Архитектура

server/src/
├── domain/              # Сущности, Value Objects, порты (ICadRepository)
├── application/         # Use cases, DTO, бизнес-логика
├── infrastructure/      # HTTP bridge (.NET plugin), COM bridge (fallback), SafeBridge
└── presentation/        # MCP сервер (stdio/SSE), 183 tool definitions

engine/CadEngine.Plugin/
├── Services/            # 35+ C# сервисов (EntityService, SolidService, SymbolService ...)
├── Models/              # DTO модели запросов/ответов
└── HttpServer.cs        # REST API (localhost:5080, 170+ endpoints)

Приоритет подключения: HTTP (.NET engine) → COM → offline

Graceful degradation: Если nanoCAD недоступен, все инструменты возвращают понятное русское сообщение об ошибке. health_check и get_system_info остаются рабочими для диагностики.

📦 Системные требования

ОС: Windows 10/11 64-bit
Python: 3.12+
nanoCAD: 26 (Free/Plus/Pro) с загруженным .NET плагином
.NET: 8.0 SDK (только для сборки плагина)

🛠 Разработка

Добавление нового инструмента

C# (engine): DTO в ApiModels.cs, метод в сервисе, route в HttpServer.cs
Python bridge: Метод в http_bridge.py
Use case: Класс в extended_use_cases.py / use_cases.py
MCP: Определение в tool_defs.py, handler map в server.py
Тесты: Unit + integration

Принципы

MultiCAD API first — все новые инструменты через .NET engine
Никаких SendCommand — все вызовы через синхронный Editor.Command() или programmatic API
Clean Architecture — строгие границы слоёв (domain → application → infrastructure → presentation)
TDD — сначала тест, потом реализация

📄 Лицензия

MIT License — проект с открытым исходным кодом.

👤 Автор

Виноградов Иван — разработчик и архитектор проекта.

🙏 Благодарности

Разработчикам nanoCAD и MultiCAD API
Сообществу Model Context Protocol
Всем контрибьюторам и тестировщикам

MCP Servers