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.
Настройка клиентов
{
"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.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
MCP Unity
Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.