AutoCAD MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUTOCAD_MCP_OUT | No | Output folder for generated drawings. | Документы/AutoCAD-MCP |
| AUTOCAD_MCP_TOKEN | No | Token/key for HTTP mode. Clients send it in the Authorization: Bearer <token> header. | |
| AUTOCAD_MCP_ENGINE | No | Drawing engine to use: auto, com, or ezdxf. auto uses AutoCAD if installed, otherwise DXF. | auto |
| AUTOCAD_MCP_PROGID | No | Manually select an AutoCAD version by ProgID, for example AutoCAD.Application.25.1. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Сервер черчения в AutoCAD (режим com, Windows) или в DXF без AutoCAD (режим ezdxf, любая ОС). Единицы: миллиметры, ось Y вверх, углы в градусах против часовой. Порядок работы: acad_status (какой режим и версия) -> new_drawing или open_drawing -> рисование -> render_preview (посмотреть результат PNG) -> save_drawing / export_pdf. Много объектов сразу: draw_batch (одна команда, один шаг отмены). Повторы: array_entities. Планы зданий: draw_axes (оси с марками), draw_walls (стены с проёмами), add_dimension_chain (цепочки размеров). Окна, двери, витражи по замеру: draw_construction, draw_order, import_order (заказы из «К-Замер»). Высоту надписей задаёт set_annotation_scale (для планов 250-500 мм, для окон 80-120), иначе авто. Найти и изменить нарисованное: list_entities / select_entities -> transform_entities, set_properties, erase_entities. Чего нет в инструментах: run_command (только com), команды на английском с префиксом _. работают в AutoCAD на любом языке.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| acad_statusA | Статус: активный движок, подключён ли AutoCAD, текущий файл, число объектов. |
| set_engineA | Переключить движок: 'auto' (COM если есть, иначе ezdxf), 'com' (живой AutoCAD) или 'ezdxf' (без AutoCAD). |
| drawing_summaryB | Сводка по чертежу: файл, число объектов (по типам в ezdxf). |
| new_drawingB | Создать новый пустой чертёж. |
| open_drawingA | Открыть существующий чертёж (DWG для COM / DXF для ezdxf) по абсолютному пути. |
| save_drawingB | Сохранить чертёж. Без пути: сохранить текущий или в папку вывода. version: год формата для старых версий AutoCAD (2018, 2013, 2010, 2007, 2004, 2000; можно год своей версии, например 2016). Возвращает путь к файлу. |
| export_dxfA | Сохранить копию чертежа в DXF (текущий файл не меняется). Без пути: в папку вывода. |
| draw_lineC | Отрезок из (x1,y1) в (x2,y2). layer: слой (по умолчанию '0'). Возвращает handle. |
| draw_polylineC | Полилиния по точкам [[x,y],...]. closed: замкнуть контур. |
| draw_rectangleC | Прямоугольник по левому нижнему углу (x,y) и размерам w×h. |
| draw_circleC | Окружность: центр (cx,cy), радиус r. |
| draw_arcA | Дуга. Либо центр (cx,cy), радиус r и углы start_angle..end_angle в градусах против часовой, либо points: три точки [[x,y] начало, [x,y] на дуге, [x,y] конец]. |
| draw_ellipseC | Эллипс: центр (cx,cy), полуоси rx (по X) и ry (по Y), rotation: поворот в градусах. |
| draw_polygonB | Правильный многоугольник: центр, радиус r, число сторон sides. inscribed=True: r до вершин, False: r до середины сторон. rotation: угол первой вершины (90 = вершина вверху). |
| draw_textB | Текст в точке (x,y), шрифт Arial (кириллица). height: высота в мм; если не указана, авто по масштабу (см. set_annotation_scale). align: 'center' или 'left'. |
| draw_mtextB | Многострочный текст (MTEXT) от точки (x,y) (левый верх; align='center': центр). Строки через \n, width: ширина абзаца (0 = без переноса), height: авто, если не указана. |
| draw_hatchA | Штриховка или заливка замкнутого контура: points [[x,y],...] или handle замкнутой полилинии/окружности/эллипса. pattern: ANSI31, ANSI37, AR-CONC, AR-B816, BRICK, GRAVEL, NET... или SOLID (заливка); scale: масштаб узора (для мм-чертежей обычно 10-50), angle: градусы, color: ACI. |
| draw_pointC | Точка (POINT) в (x,y). |
| draw_splineC | Сплайн через точки [[x,y],...]. closed: замкнуть. |
| draw_batchA | ПАКЕТНОЕ РИСОВАНИЕ: много объектов одной командой (до 5000), один шаг отмены. items: список объектов {type, ...параметры, layer?, color?, linetype?, lineweight?}. Типы и параметры: line {x1,y1,x2,y2 | p1,p2}; polyline {points,closed}; rect {x,y,w,h}; circle {cx,cy,r}; arc {cx,cy,r,start_angle,end_angle | points:3}; ellipse {cx,cy,rx,ry,rotation}; polygon {cx,cy,r,sides}; point {x,y}; spline {points}; text {x,y,text,height?,align?,rotation?}; mtext {x,y,text,width?}; dim {x1,y1,x2,y2,offset,vertical?,aligned?,text?}; hatch {points,pattern,scale}. Ошибочные элементы пропускаются, их номера и причины возвращаются. |
| array_entitiesA | МАССИВ копий объектов (handles или фильтр layer/entity_type/area). mode='rect': rows×cols с шагом dx, dy (исходник в левом нижнем углу). mode='polar': count копий по кругу вокруг (cx,cy) на угол angle (360 = полный круг), rotate_items=False: копии не поворачиваются. Исходные объекты остаются. |
| add_dimension_chainA | ЦЕПОЧКА РАЗМЕРОВ по точкам [[x,y],...] (по порядку): соседние размеры на одной линии. direction: 'horizontal' (меряется по X) или 'vertical' (по Y). at: координата размерной линии (y для horizontal, x для vertical); без неё: на 3 высоты текста ниже/левее точек. total=True: общий размер дальше от объекта. |
| draw_wallsA | СТЕНЫ ПЛАНА по осевой линии points [[x,y],...] толщиной thickness (мм), closed: замкнутый контур. openings: проёмы [{segment: № участка с 0, offset: от начала участка до края проёма, width, type: door|window|opening, swing: left|right (сторона открывания двери относительно направления участка), hinge: start|end}]. Двери с дугой открывания, окна тремя линиями. Слои WALLS, DOORS, WINDOWS. |
| draw_axesA | КООРДИНАЦИОННЫЕ ОСИ (ГОСТ 21.101): x_spacings: шаги вертикальных осей слева направо (марки 1, 2, 3...), y_spacings: шаги горизонтальных осей снизу вверх (марки А, Б, В... без Ё, З, Й, О, Х, Ц, Ч, Щ, Ъ, Ы, Ь). x/y: положение первой оси. Штрихпунктир, марки в кружках, размеры между осями и общий. both_sides: марки с двух сторон. x_labels/y_labels: свои марки. |
| add_dimensionA | Размер между (x1,y1) и (x2,y2). По умолчанию горизонтальный; vertical=True: вертикальный; aligned=True: параллельный отрезку (наклонный). offset: смещение размерной линии (для aligned: >0 слева от направления 1→2). text: своя подпись, text_height: высота текста (иначе авто). Пересекающиеся подписи разносятся автоматически. |
| add_radial_dimensionA | Радиус или диаметр (diameter=True) окружности/дуги: центр (cx,cy) и r, либо handle окружности/дуги. angle: направление выноски в градусах. |
| add_angular_dimensionC | Угловой размер: вершина (vx,vy) и точки на сторонах угла (x1,y1), (x2,y2); угол меряется от первой стороны ко второй против часовой. radius: радиус дуги размера (по умолчанию 0.6 от короткой стороны). |
| add_leaderB | Выноска (мультивыноска) с текстом: points [[x,y] остриё стрелки, ..., [x,y] где текст]. Текст можно в несколько строк через \n. |
| set_annotation_scaleA | Масштаб надписей: высота текста размеров и подписей в мм для всего чертежа. Для планов зданий задайте крупно (500-1000 мм), для окон 80-120. 0 = авто (≈1/60 габарита, не меньше 80 мм). |
| create_layerA | Создать слой или поменять цвет существующего: имя и цвет AutoCAD (ACI 1..255). Рисование на слое цвет не сбрасывает. |
| set_layerB | Настроить слой (создаётся, если нет): on (вкл/выкл), frozen, locked, color (ACI), linetype (DASHED, CENTER, HIDDEN...: подгружается сам), lineweight (мм, напр. 0.5), current=True: сделать текущим. |
| delete_layerB | Удалить пустой слой (не 0, не Defpoints, не текущий). |
| list_layersA | Список слоёв: цвет, вкл/заморожен/заблокирован, тип линии, текущий. |
| list_entitiesA | Список объектов модели с handle, типом, слоем, цветом и габаритом. Фильтр: layer (шаблон, напр. 'WALL*'), entity_type (тип DXF: LINE, LWPOLYLINE, CIRCLE, ARC, TEXT, MTEXT, DIMENSION, INSERT, HATCH...; через запятую), area [x1,y1,x2,y2] (целиком внутри; crossing=True: касается). limit: максимум в ответе. |
| get_entityB | Подробно об объекте по handle: геометрия, текст, атрибуты блока, длина/площадь. |
| select_entitiesA | Выбрать объекты по фильтру и вернуть их handle (для правки другими инструментами). Фильтр: layer (шаблон, напр. 'WALL*'), entity_type (тип DXF: LINE, LWPOLYLINE, CIRCLE, ARC, TEXT, MTEXT, DIMENSION, INSERT, HATCH...; через запятую), area [x1,y1,x2,y2] (целиком внутри; crossing=True: касается). |
| transform_entitiesA | Преобразовать объекты (handles или фильтр layer/entity_type/area). op: move (dx,dy), copy (dx,dy), rotate (angle° вокруг base_x,base_y), scale (factor от base), mirror (ось axis=[x1,y1,x2,y2]). copy=True: оставить исходные и изменить копии. Возвращает handle новых объектов. |
| erase_entitiesB | Удалить объекты по списку handles или по фильтру (layer/entity_type/area). |
| set_propertiesA | Сменить свойства объектов (handles или фильтр filter_layer/entity_type/area): layer (перенести на слой), color (ACI, 256 = по слою), linetype (DASHED, CENTER...), lineweight (мм; -1 по слою), ltscale: масштаб типа линии (для 1:100 обычно 100, иначе штрихи сливаются). |
| offset_entityB | Смещённая копия (OFFSET) отрезка, полилинии, окружности или дуги на distance. Сторону задайте точкой (side_x, side_y); без неё distance>0: влево от направления / наружу для окружности. |
| measureB | Измерить: длина/площадь/периметр объекта по handle, или расстояние между точками (x1,y1)-(x2,y2). |
| create_blockA | Создать блок name из объектов (handles) или из конструкции (kind + params, как в draw_construction). base_x/base_y: базовая точка. replace=True: исходные объекты заменяются вставкой блока. attributes: список тегов атрибутов (например ['MARK','NOTE']). |
| insert_blockB | Вставить блок: name (или путь к .dwg в COM / .dxf в ezdxf), точка (x,y), scale, rotation°, attributes: {ТЕГ: значение}. |
| list_blocksA | Список блоков (теги атрибутов, число вставок). include_inserts=True: вставки с handle и значениями атрибутов. |
| add_tableB | Таблица от левого верхнего угла (x,y): rows [[...],...], header (заголовки колонок), title, col_widths (мм, иначе по тексту), text_height (иначе авто). В COM родная таблица AutoCAD, в ezdxf линии+текст. |
| make_sheetA | Лист: рамка формата A4/A3/A2/A1 (landscape) в модели в масштабе 1:scale (0 = подобрать) вокруг области area [x1,y1,x2,y2] или всего чертежа, с основной надписью ГОСТ 2.104 (форма 1): title (наименование), number (обозначение), developer, checker, date, organization, sheet/sheets. side_stamp: дополнительные графы на левом поле (Инв. № подл., Подп. и дата, Взам. инв. №, Перв. примен.) и «Копировал / Формат» под рамкой. После него export_pdf без параметров печатает этот лист, export_pdf(all_sheets=True) все листы чертежа одним PDF. |
| export_pdfA | PDF. Без area/format печатает последний лист make_sheet в его масштабе; all_sheets=True: все листы make_sheet этого чертежа одним многостраничным PDF (по номерам листов). Иначе format (A4..A1), landscape, area [x1,y1,x2,y2] или весь чертёж, scale 1:N (0 = вписать). monochrome: чёрно-белый. COM: плоттер DWG To PDF.pc3; ezdxf: matplotlib. |
| list_profilesB | Каталог профилей: артикул, назначение (стойка/ригель/стропило/рама/импост/створка/прижим/крышка), глубина, Ix см4. |
| set_profileA | Добавить или исправить профиль в каталоге: article, name, role (стойка, ригель, стропило, рама, импост, створка, прижим, крышка, прочее), depth_mm, ix_cm4 (момент инерции для статрасчёта, по каталогу системодателя). |
| static_calcA | СТАТИЧЕСКИЙ РАСЧЁТ стойки, импоста или стропила на прогиб (СНиП 2.01.07-85*, табл. 42 СНиП 2.03.06-85), как в проектах. length_mm: длина элемента между опорами, angle_deg: угол к горизонтали (90 = вертикальная стойка), step_mm: шаг стоек, glass_mm: общая толщина стекла в стеклопакете, snow_region I..VIII, wind_region Iа..VII, terrain A/B/C, height_m: высота объекта, igu: стеклопакет (прогиб L/300) или одинарное стекло (L/200), steel: сталь вместо алюминия. Профиль подбирается из каталога (list_profiles) или задаётся article. draw=True: лист расчёта А4 в чертеже. |
| render_previewA | PNG-превью чертежа (светлый фон) для проверки результата. area [x1,y1,x2,y2] или весь чертёж. Возвращает путь к файлу. |
| draw_constructionA | Чертёж конструкции по замеру. kind: frame | window | door | vitrazh | balcony | loggia (раздвижное) | partition | generic. frame (любая схема из конструктора): {width,height,outward,view,frame}, frame = {fill:{t,hinge,dir}} или {split:{dir:'v'|'h',sizes:[мм],parts:[...],shtulp?}}; t: glass|panel|turn|tiltturn|tilt|tophung|door|slide, hinge: left|right (петли, вид изнутри), sizes от края рамы до оси импоста. params (мм): window={width,height,profile,outward,sashes:[{width,type,hinge|handle}]} (type: Глухое/Поворотное/Поворотно-откидное/Откидное); door={width,height,side,door_type,outward}; vitrazh={width,height,columns,rows}; balcony={width,height,door_width,door_side}; loggia={width,height,sections}; прочее={width,height,name}. view='outside': вид снаружи. |
| draw_orderA | Заказ из нескольких конструкций одной командой: items [{kind, params, name?, qty?}] (kind/params как в draw_construction), раскладка в ряд от (x,y), подписи «Поз. N» и таблица-спецификация (поз., изделие, Ш×В, площадь м², створки/открывание, кол-во). customer {client,address}: в заголовок. |
| import_orderA | Импорт заказа из «К-Замер»: data = JSON заказа {customer, items:[{templateId, values}]}, файл резервной копии {app:'k-zamer', orders:[...]} или путь к .json. Строит все изделия и спецификацию. order_index: какой заказ из бэкапа (по умолчанию все, друг под другом). |
| run_commandA | ПРЯМАЯ КОМАНДА AutoCAD (только COM): строка как в командной строке, напр. '.CHAMFER' или '.FILLET _R 50'. Пробел/Enter в конце добавляется сам. Пишите английские имена команд и опций с префиксом _ (они работают в AutoCAD на любом языке). Выполняется без проверок, используйте, когда нет подходящего инструмента. |
| undoB | Отменить последние действия (только COM): steps шагов UNDO. Одна команда MCP = один шаг. |
| zoomA | Показать весь чертёж (mode='extents') или область (mode='window', area=[x1,y1,x2,y2]). |
| purgeB | Очистить чертёж от неиспользуемого (PURGE): пустые слои, неиспользуемые блоки и стили. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 58 tools
Most tools have clearly distinct purposes (draw_line vs draw_circle vs draw_spline, dimension variants target different geometry). A few overlaps exist: create_layer vs set_layer (both can create/change color), and list_entities vs select_entities (both accept the same filters and return handles), which could confuse an agent. Descriptions mostly resolve these, so the set is largely coherent.
Nearly all tools follow a snake_case verb+noun pattern (draw_*, add_*, set_*, list_*, create_*, erase_*, transform_*, export_*). Minor deviations exist: noun-centric names like acad_status, drawing_summary, new_drawing, run_command, render_preview, undo, measure. Still highly readable and predictable.
58 tools is heavy for a single server; several individual draw_* primitives are made redundant by draw_batch, which suggests consolidation was possible. The breadth (drafting, layers, dimensions, blocks, sheets, structural calc, order import) justifies many of them, but the surface feels over-scoped and borderline unmanageable for an agent to navigate.
Coverage is very thorough: drawing primitives, layer/block lifecycle, entity query/edit/delete, all dimension types, sheet creation, PDF/DXF export, structural calculation, and construction/order workflows. Minor gaps exist (e.g., no direct text-content editing or block redefine), but agents can work around them, often via run_command or erase+recreate.