Позволяет AI-агентам для написания кода искать точные функции, параметры, примеры и руководства Bitbybit для 3D параметрического CAD API.
Также известен как bitbybit-dev/bitbybit, cad, @bitbybit-dev/mcp
- Звёзды
- 211
- Инструменты
- 5
- Загрузки, 30 дней
- 1 001
- Последняя версия
- 1.6.2
- Последний коммит
- 14 нояб. 2026 г.
- Лицензия
- MIT
Что такое Bitbybit CAD MCP?
Bitbybit CAD — это MCP server. Позволяет AI-агентам для написания кода искать точные функции, параметры, примеры и руководства Bitbybit для 3D параметрического CAD API. Он предоставляет 5 инструментов, например search_api, describe, list_namespace.
Сводка сгенерирована из README проекта
О Bitbybit CAD MCP server
Bitbybit CAD MCP предоставляет AI-агентам для написания кода точную документацию по 3D параметрическому CAD API. Это предотвращает ситуацию, когда агенты выдумывают несуществующие названия функций, позволяя им находить точные параметры, типы возвращаемых значений и примеры для любых из 2210 функций, доступных в трех CAD-ядре. Это гарантирует, что сгенерированный код скомпилируется правильно с первой попытки.
Разработчики могут использовать этот сервер локально через stdio с помощью npx или удаленно через streamable HTTP. Он совместим с различными средами, включая Cursor, VS Code, Claude Code и IDE от JetBrains. Сервер определяет конкретную версию API, используемую в проекте, чтобы предоставить контекст, точно соответствующий этой версии. Он также классифицирует инструменты по уровням обслуживания, таким как oss, platform-pro или cloud-pro, чтобы агенты не предлагали платные сервисы для задач, которые можно решить с помощью бесплатных npm-пакетов.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Bitbybit CAD MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Bitbybit CAD MCP в Claude Code
$ claude mcp add cad -- npx -y @bitbybit-dev/mcpУстановка Bitbybit CAD MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cad": {
"command": "npx",
"args": [
"-y",
"@bitbybit-dev/mcp"
]
}
}
}Установка Bitbybit CAD MCP в VS Code
.vscode/mcp.json
{
"servers": {
"cad": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bitbybit-dev/mcp"
]
}
}
}Установка Bitbybit CAD MCP в VS Code CLI
$ code --add-mcp '{"name":"cad","type":"stdio","command":"npx","args":["-y","@bitbybit-dev/mcp"]}'Установка Bitbybit CAD MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cad": {
"command": "npx",
"args": [
"-y",
"@bitbybit-dev/mcp"
]
}
}
}Установка Bitbybit CAD MCP в Codex
$ codex mcp add cad -- npx -y @bitbybit-dev/mcpУстановка Bitbybit CAD MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.cad] command = "npx" args = ["-y", "@bitbybit-dev/mcp"]
Установка Bitbybit CAD MCP в Gemini CLI
$ gemini mcp add -s user cad npx -- -y @bitbybit-dev/mcpУстановка Bitbybit CAD MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cad": {
"command": "npx",
"args": [
"-y",
"@bitbybit-dev/mcp"
]
}
}
}Инструменты Bitbybit CAD MCP 5
Определено из READMEsearch_apidescribelist_namespaceget_examplesget_guide
| search_api | — | |
| describe | — | |
| list_namespace | — | |
| get_examples | — | |
| get_guide | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSПройдено
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHub@bitbybit-dev/mcp: the Bitbybit CAD MCP server
An MCP server that documents the Bitbybit 3D CAD API for AI coding agents: every function, its parameters, defaults, return type and examples, for the exact version your project uses. Bitbybit has 2205 functions across three CAD kernels - more than any model holds in memory - so an agent working from memory invents plausible names that do not exist. An agent with this server looks each one up instead, and writes code that compiles the first time.
It answers from the API index Bitbybit publishes with every release (https://git-cdn.bitbybit.dev/v<version>/ai-context/index.json), never from memory, and never from a moving "latest".
The diagram shows what an agent is writing code for. The MIT-licensed npm packages run the CAD kernels in your users' browsers or in your own Node process; script runners load the same engine from one file; the CAD Cloud REST API runs the work on managed servers. This server knows all of them, and every answer carries a tier - oss, platform-pro or cloud-pro - so an agent never sends you to a paid service for something the free packages already do.
Connect it
The same server runs two ways. Hosted at https://mcp.bitbybit.dev/mcp over Streamable HTTP, which needs nothing installed and serves the newest release; or locally over stdio with npx, which needs Node 20 and serves the version your project has installed. Start with the remote.
Claude Code
claude mcp add --transport http bitbybit https://mcp.bitbybit.dev/mcp
or the local server:
claude mcp add --transport stdio bitbybit -- npx -y @bitbybit-dev/mcp
For a project, commit a .mcp.json at its root so every collaborator's Claude Code finds it:
{ "mcpServers": { "bitbybit": { "type": "http", "url": "https://mcp.bitbybit.dev/mcp" } } }
Cursor (.cursor/mcp.json)
{ "mcpServers": { "bitbybit": { "url": "https://mcp.bitbybit.dev/mcp" } } }
VS Code (.vscode/mcp.json) - the type is required, or VS Code tries to start the URL as a program:
{ "servers": { "bitbybit": { "type": "http", "url": "https://mcp.bitbybit.dev/mcp" } } }
Either form takes the local server instead: { "command": "npx", "args": ["-y", "@bitbybit-dev/mcp"] }, with "type": "stdio" in VS Code.
Codex
codex mcp add bitbybit --url https://mcp.bitbybit.dev/mcp
or codex mcp add bitbybit -- npx -y @bitbybit-dev/mcp for the local server. In ~/.codex/config.toml that is [mcp_servers.bitbybit] with url = "https://mcp.bitbybit.dev/mcp".
Gemini CLI (gemini mcp add -t http bitbybit https://mcp.bitbybit.dev/mcp), Windsurf (serverUrl in ~/.codeium/windsurf/mcp_config.json), Zed (context_servers in its settings) and the JetBrains IDEs (AI Assistant, MCP, a JSON entry with url) take the same address. claude.ai, ChatGPT and the Claude API connect to the remote as a custom connector - every configuration is documented here.
Which version it serves
The server documents one exact version of the API. It picks it in this order:
--version <version>on the command line;BITBYBIT_VERSION=<version>in the environment;- the version of the
@bitbybit-devpackages installed around the working directory (core, then the renderer packages, thenocct); packages that disagree are reported on stderr and the first wins; - its own version, which is the newest API version it was released with.
Indexes are cached in $XDG_CACHE_HOME/bitbybit-mcp (or ~/.cache/bitbybit-mcp); --no-cache skips the cache. Everything the program prints goes to stderr; stdout is the protocol.
Tools
| Tool | What it answers |
|---|---|
search_api |
members by keywords, with path, summary, tier and engines |
describe |
the full contract of one member by dotted path, naming the types it returns or takes; such a type by its name, field by field; an unknown path is reported with the nearest existing ones |
list_namespace |
the members one level below a namespace |
get_examples |
code examples for a member, a namespace or a topic |
get_guide |
sections of the public guides: where geometry should run, how to build, check and export parts with the kernels, how to write design documents, and how to write IFC building models |
search, fetch |
the same lookups in the shape ChatGPT connectors require |
Every tool is read-only. Tiers in the answers: oss (in the npm packages, MIT), platform-pro (only when scripting inside bitbybit.dev), cloud-pro (only on CAD Cloud, with an API key).
The companion server
This server answers questions; it never runs geometry. When you want the agent to produce geometry - measure a STEP file, run a pipeline, unfold a sheet-metal part, convert to glTF - connect the Bitbybit CAD Cloud MCP alongside it, with a CAD Cloud API key:
claude mcp add --transport http bitbybit-cloud https://api.bitbybit.dev/mcp --header "X-API-Key: <your key>"
In Codex the same is [mcp_servers.bitbybit-cloud] with url = "https://api.bitbybit.dev/mcp" and env_http_headers = { "X-API-Key" = "BITBYBIT_API_KEY" }, the key read from the environment.
The two are designed to work together: the agent learns a member here and calls it there with the same dotted path and the same argument object.
As a library
The package exports the tool registry and the index reader, so another server can serve the same tools:
import { createDocsRegistry, contextForIndex, GUIDES, GUIDE_PAGE_URL } from "@bitbybit-dev/mcp";
import { loadIndex } from "@bitbybit-dev/mcp/index-loader";
import { createMcpServer } from "@bitbybit-dev/mcp/server";
const version = "<a released version>";
const index = await loadIndex({ version });
const context = contextForIndex(index, GUIDES, GUIDE_PAGE_URL);
const server = createMcpServer(createDocsRegistry(), context, { name: "bitbybit", version });
toHttp(registry, context) renders the same tools for a plain HTTP endpoint, and guarded(registry, report) is the error boundary every server puts around a registry: a handler that throws answers a generic error result and the throw goes to report, so no internal message reaches a client. Registry.map(wrap) re-wraps every handler for such concerns of your own. The package root imports no Node built-in, so a bundler can take it into an edge runtime; the loader and the version detector, which read the file system, are the separate index-loader and installed-version entries, and the $ref inliner the tool schemas go through is the dependency-free json-schema entry.
Privacy
The stdio server sends nothing anywhere except one request to the CDN for the index of the version it serves.
Links
| Resource | URL |
|---|---|
| Using AI with Bitbybit | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro |
| This server, documented | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/bitbybit-mcp |
| CAD Cloud MCP | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/mcp/cad-cloud-mcp |
| Agentic CAD - where geometry should run | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/agentic-cad |
| Context files, for hosts without MCP | https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/prompt-contexts |
| GitHub | https://github.com/bitbybit-dev/bitbybit/tree/master/packages/dev/mcp |
| Monorepo | https://github.com/bitbybit-dev/bitbybit |
| TypeScript API Reference | https://docs.bitbybit.dev |
Bitbybit Platform
Beyond NPM packages, Bitbybit offers:
- Visual Programming Editors - Rete & Blockly drag-and-drop 3D modeling, plus a Monaco TypeScript editor
- CAD Cloud API - Build full pipelines that compose all Bitbybit algorithms, where each step can reference outputs of previous steps. Supports parametric model generation, STEP-to-glTF conversion, and complex CAD workflows via HTTP
- Bitbybit Studio - A growing visual dashboard where API Key users can generate models, convert files, build pipelines with a GUI, inspect tasks, and preview 3D results
- 3D Bits for Shopify - Interactive 3D product configurators for e-commerce
- Script Runners - Execute visual scripts directly on your website
- Built for AI Coding Agents - This server, the CAD Cloud MCP for running geometry, and context files for assistants without MCP
- Business & Enterprise - We help businesses and enterprises develop custom applications and spin up optimized CAD tenant workflows on our managed servers
Support the Project
This package is part of the open-source Bitbybit ecosystem. Your subscription helps fund continued development.
⭐ Subscribe - Silver or Gold plan | Get API Key for CAD Cloud
Community
License
MIT © Bit By Bit Developers
Вопросы о Bitbybit CAD MCP
Как добавить Bitbybit CAD MCP в Claude Code?
Выполните claude mcp add cad -- npx -y @bitbybit-dev/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Bitbybit CAD MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет Bitbybit CAD MCP?
Он предоставляет 5 инструментов, включая search_api, describe, list_namespace, get_examples, get_guide.
Какую версию API документирует сервер?
Версию можно зафиксировать с помощью флага --version или переменной окружения BITBYBIT_VERSION, в противном случае сервер определяет версию установленных пакетов @bitbybit-dev, а если они не найдены — использует свою собственную версию релиза.
Какие инструменты предоставляет Bitbybit CAD MCP server?
Он предлагает search_api, describe, list_namespace, get_examples, get_guide, а также search и fetch для коннекторов ChatGPT. Все инструменты работают только в режиме чтения.
Выполняет ли Bitbybit CAD MCP server геометрические операции?
Нет, он только отвечает на вопросы об API. Для непосредственного создания геометрии необходимо подключить сопутствующий Bitbybit CAD Cloud MCP с API-ключом CAD Cloud.
Нужен ли API-ключ?
Нет, сервер документации бесплатен и распространяется под лицензией MIT. API-ключ CAD Cloud требуется только для сопутствующего сервера CAD Cloud MCP, который отвечает за выполнение геометрии.