OpenTakeoff MCP
MCP-сервер обмера строительных чертежей: агент открывает PDF, ставит масштаб, считает площади и отдает размеченный набор листов
- 716 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Сервер читает PDF-чертежи по путям на диске и пишет размеченные PDF и экспорты
- Замеры агента влияют на цену заявки: масштаб и контуры нужно подтверждать человеком
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/opentakeoffОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает PDF-чертежи по путям на диске и пишет размеченные PDF и экспорты
- Замеры агента влияют на цену заявки: масштаб и контуры нужно подтверждать человеком
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenTakeoff решает задачу обмера: по строительному чертежу считает, сколько пола, стен и каких предметов предусмотрено. MCP-сервер в стандартной сборке дает агенту 53 инструмента. Команда load_plan открывает PDF-чертеж с диска, sheet_info показывает размеры листа и найденный на нем масштаб, set_scale задает масштаб по метке, по двум точкам с известным расстоянием или по найденному. Масштаб остается неподтвержденным, пока человек не подтвердит его в браузерном редакторе. Дальше агент обводит помещения командой measure_polygon по внутренним граням стен и проверяет себя на отрисованном листе через view_sheet. В конце он отдает размеченный PDF набора листов. В каждой фигуре хранятся масштаб, способ замера (вручную, трассировка, предложение агента) и отметка о правке человеком, поэтому у каждой цифры в расчете есть история. Те же расчеты доступны в браузерном редакторе на opentakeoff.kentucky-ai.com. Он работает без аккаунта, чертежи никуда не загружаются. Агент и человек работают с одним документом обмера и общими формулами количеств. Автоопределение помещений One-Click пока отключено: его проверяют на более широком наборе планов.
Для кого. Для сметчиков и специалистов по подготовке тендеров, которые считают объемы по PDF-чертежам, и для тех, кто подключает к такой работе Claude Code, Cursor или Claude Desktop.
Подходит, если
- Готовите заявку на отделку полов и хотите получить площади помещений с листа чертежа
- Масштаб листа нужно задать или проверить: set_scale принимает метку, калибровку по двум точкам или найденное на листе значение
- Замеры должны оставлять след проверки: фигуры хранят масштаб, способ и правку человеком, а набор уходит размеченным PDF
- Планы, таблицу отделки помещений и дополнения нужно свести в один расчет: load_plan с параметром merge: true добавляет документ в рабочий набор
- Агенту нужно проверить результат глазами: view_sheet с наложением показывает лист с нарисованными контурами
Не подходит, если
- Чертежи лежат в DWG, а не в PDF, или нужна модель Revit: сервер открывает PDF-листы
- Нужна трассировка всех помещений одним щелчком: One-Click и detect_rooms в стандартной сборке отключены, помещения обводят через measure_polygon
- Нужен итоговый документ для заказчика без проверки специалистом: решение о масштабе остается за человеком
- На машине нет Node.js 20 или новее и нет Docker, а ставить их нельзя
Пример запроса к агенту
Открой demo/sample-plan.pdf, проверь масштаб первого листа, обведи помещения и покажи таблицу площадей: что подтверждено человеком, а что нетMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OPENTAKEOFF_MCP_STAGED_TOOLS- Значение 1 включает поэтапное открытие инструментов вместо полного списка сразу.
OPENTAKEOFF_ONE_CLICK- Значение 1 регистрирует отключенные инструменты one_click и detect_rooms.
OPENTAKEOFF_MCP_TRACE- Значение 1 пишет в stderr по одной строке JSON на вызов: имя инструмента, время и размер ответа, без текста документа.
Ограничения
В описании инструмента set_scale расстояние калибровки задается в футах, а публичные примеры планов взяты из США. Работу с метрическими чертежами проверьте на своем листе до расчета.
One-Click и detect_rooms не регистрируются в стандартной сборке. Пути определения помещений в браузере и в MCP пока различаются, одинаковые границы на любом плане не гарантированы.
Проект выпущен под AGPL-3.0: условия лицензии действуют и для собственной копии, размещенной как сетевой сервис.
Как отключить. Удалите блок opentakeoff из конфигурации MCP-клиента. В Claude Code это команда claude mcp remove opentakeoff. Размеченные PDF и экспорты остаются там, куда вы их сохранили. Удалите их вручную.
Частые вопросы
Как подключить OpenTakeoff к Claude Code или Cursor?
В Claude Code выполните claude mcp add opentakeoff -- npx -y opentakeoff-mcp. В Cursor и других клиентах со stdio добавьте в конфигурацию команду npx с аргументами -y и opentakeoff-mcp. Для Claude Desktop есть пакет opentakeoff-mcp.mcpb со страницы релизов: он ставится двойным щелчком, Node.js не нужен.
Нужны ли аккаунт и загрузка чертежей в облако?
Браузерный редактор работает без аккаунта, чертежи при этом никуда не загружаются. MCP-сервер работает по stdio на вашей машине и читает PDF по пути на диске. В Docker локальную папку с планами подключают только для чтения.
Почему замеры агента нужно подтверждать?
Агентские замеры получают явный статус проверки, а масштаб, заданный через set_scale, остается неподтвержденным, пока человек не подтвердит его в редакторе. Так результат работы агента нельзя принять за проверенный.
Почему в списке нет One-Click и detect_rooms?
Эти два инструмента отключены, пока алгоритм автоопределения помещений проверяют на более широком наборе планов. Переменная окружения OPENTAKEOFF_ONE_CLICK=1 регистрирует их, тогда инструментов становится 55.
Как уменьшить число инструментов в контексте агента?
Задайте OPENTAKEOFF_MCP_STAGED_TOOLS=1. Сначала доступны одиннадцать инструментов этапа подготовки и инструмент open_tool_stage, остальные появляются по запросу агента. Нужен клиент, который понимает обновление списка инструментов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный удаленный MCP-сервер конструктора опросов WebAsk и 25 навыков: анкета по описанию, проверка перед запуском, ответы и отчеты
MCP-сервер Trello на 57 инструментов: карточки, списки, чек-листы, вложения, комментарии, поля и рабочие пространства, плюс выгрузка критериев приемки
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Планфикс MCP
planfix-mcp
MCP-сервер Планфикса: задачи, проекты, контакты, комментарии и сотрудники через REST API
CLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OpenTakeoff (эта запись) | нет | не нужна | 716 | |
| DDC Skills for Construction | нет | 375 | набор скиллов для строительных компаний: выгрузка из BIM в Excel, расценки и сметы | |
| rvt-mcp (Bimwright) | нет | не нужна | 106 | работает внутри Revit с моделью здания |
Коротко о README
Документация описывает один движок обмера с двумя входами: MCP-сервер для агента и браузерный редактор для человека, которые используют общие модули геометрии и количеств. Отдельно есть руководства для агентов и для пользователей, черновик протокола обмена данными обмеров и наборы публичных планов с эталонными контурами для прогонов агентов без подсказок. Раздел о собственной копии объясняет, как поднять свой экземпляр. Свежие правки касаются правил обводки помещений и полного цикла проверки человеком импортированного агентом обмера.