Bitbybit CAD MCP

Bitbybit CAD MCP — официальный MCP-сервер от bitbybit-dev. Документация параметрического 3D CAD API Bitbybit для агентов-программистов: поиск, примеры и руководство. Подключается как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
bitbybit-dev
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: medium

Только чтение документации; локальный сервер запрашивает индекс версии с CDN Bitbybit.

Настройка клиентов

codex
{
    "code": "codex mcp add bitbybit --url https://mcp.bitbybit.dev/mcp",
    "lang": "bash",
    "notes": "Облачный сервер",
    "verified": "docs"
}

Что умеет

@bitbybit-dev/mcp — MCP-сервер с документацией 3D CAD API Bitbybit для ИИ-агентов, которые пишут код. Он знает каждую функцию, её параметры, значения по умолчанию, тип результата и примеры — для той версии, которую использует ваш проект. В Bitbybit 2210 функций на трёх CAD-ядрах, больше, чем модель способна удержать в памяти, поэтому агент без справочника придумывает правдоподобные, но несуществующие имена.

Сервер отвечает по индексу API, который Bitbybit публикует с каждым релизом, — не по памяти и не по плавающей «последней» версии. Инструменты:

  • search_api — поиск функций по ключевым словам с путём, кратким описанием, уровнем доступа и ядрами;
  • describe — полный контракт функции по точечному пути с типами аргументов и результата; для неизвестного пути предлагает ближайшие существующие;
  • list_namespace — функции на уровень ниже пространства имён;
  • get_examples — примеры кода для функции, пространства имён или темы;
  • get_guide — разделы руководств: где выполнять геометрию, как строить, проверять и экспортировать детали, как писать IFC-модели зданий;
  • search и fetch — те же запросы в формате, который нужен коннекторам ChatGPT.

Все инструменты только читают. В ответах указан уровень: oss (открытые npm-пакеты под MIT), platform-pro (только в скриптах на bitbybit.dev) и cloud-pro (только в CAD Cloud с ключом API). Сам сервер геометрию не строит — для этого есть отдельный сервер CAD Cloud MCP, который работает с ключом API и принимает те же пути и аргументы.

Кому подойдёт

  • Разработчикам 3D-конфигураторов и CAD-приложений на Bitbybit, которые пишут код с ИИ-агентом.
  • Командам, которым важно, чтобы агент использовал API именно той версии, что стоит в проекте.
  • Тем, кто строит собственный MCP-сервер: пакет экспортирует реестр инструментов и загрузчик индекса как библиотеку.

Похожие серверы — в категории 3D и геймдев.

Установка

Сервер работает двумя способами. Облачный по адресу https://mcp.bitbybit.dev/mcp ничего не требует и отдаёт документацию самого свежего релиза — авторы советуют начинать с него. Локальный запускается через npx, требует Node.js 20 и отдаёт документацию той версии, которая установлена в проекте.

Локальный сервер выбирает версию так: параметр --version, затем переменная BITBYBIT_VERSION, затем версия установленных пакетов @bitbybit-dev рядом с рабочим каталогом, и наконец собственная версия. Если установленные пакеты расходятся по версиям, сервер сообщает об этом и берёт первую. Индексы кэшируются в ~/.cache/bitbybit-mcp (или в $XDG_CACHE_HOME/bitbybit-mcp); флаг --no-cache отключает кэш.

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

Команды и конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http bitbybit https://mcp.bitbybit.dev/mcp

Для Cursor конфиг кладут в .cursor/mcp.json, для VS Code — в .vscode/mcp.json; в VS Code поле type обязательно, иначе редактор попытается запустить адрес как программу. Локальный сервер в Claude Code подключается командой claude mcp add --transport stdio bitbybit -- npx -y @bitbybit-dev/mcp, в Codex — codex mcp add bitbybit -- npx -y @bitbybit-dev/mcp. Для общего проекта в Claude Code можно закоммитить .mcp.json в корень репозитория.

Проверка

Спросите агента, какие функции Bitbybit есть для построения фаски, и попросите показать контракт одной из них — он вызовет search_api и describe.

Примеры задач

Найди в API Bitbybit функцию для экспорта детали в STEP и покажи пример.
Какие функции есть в пространстве имён для работы с проволочными контурами?

Риски

  • Только чтение. Сервер не меняет файлы и не строит геометрию.
  • Сеть. По README, локальный сервер отправляет только один запрос — к CDN за индексом нужной версии. Облачный сервер видит ваши поисковые запросы к документации.
  • Чтение проекта. Локальный сервер смотрит версии установленных пакетов @bitbybit-dev рядом с рабочим каталогом.

Частые вопросы

Нужен ли ключ API?

Для этого сервера — нет. Ключ CAD Cloud нужен только сопутствующему серверу, который выполняет геометрию.

Какую версию API он показывает?

Облачный — самую свежую; локальный — ту, что установлена в проекте, или заданную вручную.

Работает ли он с Gemini CLI и Windsurf?

По README, они принимают тот же адрес облачного сервера.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники