Bitbybit CAD MCP

@bitbybit-dev/mcp：Bitbybit CAD MCP サーバー

AI コーディングエージェント向けに、Bitbybit 3D CAD API をドキュメント化する MCP サーバーです。プロジェクトで使用している正確なバージョンについて、すべての関数、パラメーター、既定値、戻り値の型、使用例を提供します。Bitbybit には 3 つの CAD カーネルにまたがって 2205 個の関数があり、どのモデルのメモリにも収まりきりません。そのため、記憶だけを頼りに作業するエージェントは、実在しないもっともらしい名前をでっち上げてしまいます。このサーバーを使うエージェントは、代わりに関数をひとつずつ検索するため、最初からコンパイルできるコードを書けます。

回答は、Bitbybit が各リリースで公開する API インデックス（https://git-cdn.bitbybit.dev/v<version>/ai-context/index.json）を参照し、記憶や変動する「latest」には頼りません。

この図は、エージェントが何のためにコードを書いているのかを示しています。MIT ライセンスの npm パッケージは、ユーザーのブラウザーまたは独自の Node プロセスで CAD カーネルを実行します。スクリプトランナーは、同じエンジンを単一のファイルから読み込みます。CAD Cloud REST APIは、マネージドサーバー上で処理を実行します。このサーバーはそのすべてを把握しており、すべての回答にティア（oss、platform-pro、cloud-pro）を付けるため、無料パッケージでできることなのに、有料サービスを勧められることはありません。

接続方法

同じサーバーを 2 通りの方法で実行できます。インストール不要で最新リリースを提供する Streamable HTTP 経由のホスト版（https://mcp.bitbybit.dev/mcp）と、Node 20 が必要で、プロジェクトにインストール済みのバージョンを提供する npx 経由のローカル版（stdio）です。まずはリモート版から始めてください。

Claude Code

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

またはローカルサーバーの場合：

claude mcp add --transport stdio bitbybit -- npx -y @bitbybit-dev/mcp

プロジェクトで使う場合は、ルートに .mcp.json をコミットして、すべての共同作業者が Claude Code から見つけられるようにします。

{ "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）- type は必須です。指定しないと、VS Code は URL をプログラムとして起動しようとします。

{ "servers": { "bitbybit": { "type": "http", "url": "https://mcp.bitbybit.dev/mcp" } } }

どちらの設定でも、ローカルサーバーを指定できます。{ "command": "npx", "args": ["-y", "@bitbybit-dev/mcp"] } を使い、VS Code では "type": "stdio" を指定します。

Codex

codex mcp add bitbybit --url https://mcp.bitbybit.dev/mcp

または、ローカルサーバーには codex mcp add bitbybit -- npx -y @bitbybit-dev/mcp を使います。~/.codex/config.toml では、[mcp_servers.bitbybit] に url = "https://mcp.bitbybit.dev/mcp" を指定します。

Gemini CLI（gemini mcp add -t http bitbybit https://mcp.bitbybit.dev/mcp）、Windsurf（~/.codeium/windsurf/mcp_config.json の serverUrl）、Zed（設定の context_servers）、JetBrains IDE（AI Assistant、MCP、url を含む JSON エントリー）も同じアドレスを使います。claude.ai、ChatGPT、Claude API はカスタムコネクターとしてリモートサーバーに接続します。すべての設定はこちらに記載されています。

対応するバージョン

サーバーは API の正確なバージョンを 1 つドキュメント化します。次の順序でバージョンを選択します。

1. コマンドラインの --version <version>；
2. 環境変数の BITBYBIT_VERSION=<version>；
3. 作業ディレクトリの周辺にインストールされている @bitbybit-dev パッケージのバージョン（core、次にレンダラーパッケージ、最後に occt）；バージョンが一致しないパッケージがある場合は stderr に報告され、最初のものが優先されます；
4. サーバー自身のバージョン。これは、サーバーがリリースされた時点での最新の API バージョンです。

インデックスは $XDG_CACHE_HOME/bitbybit-mcp（または ~/.cache/bitbybit-mcp）にキャッシュされます。--no-cache を指定するとキャッシュをスキップします。プログラムの出力はすべて stderr に送られ、stdout はプロトコル用です。

ツール

ツール	回答する内容
search_api	キーワードでメンバーを検索し、パス、概要、ティア、エンジンを表示します
describe	ドット区切りのパスで指定したメンバーの完全な仕様を表示し、そのメンバーが返す、または受け取る型を示します。型を名前で指定すると、フィールドごとに表示します。不明なパスの場合は、最も近い既存のパスを報告します
list_namespace	名前空間の 1 つ下の階層にあるメンバーを表示します
get_examples	メンバー、名前空間、またはトピックのコード例を表示します
get_guide	公開ガイドの各セクションを表示します。ジオメトリを実行する場所、カーネルを使ったパーツの構築、チェック、エクスポート方法、設計ドキュメントの作成方法、IFC 建築モデルの作成方法を扱います
search、fetch	ChatGPT コネクターが必要とする形式で、同じ検索を行います

すべてのツールは読み取り専用です。回答に示されるティア：oss（npm パッケージに含まれ、MIT ライセンス）、platform-pro（bitbybit.dev 内でスクリプトを実行する場合のみ）、cloud-pro（API キーを使って CAD Cloud 上で実行する場合のみ）。

連携サーバー

このサーバーは質問に回答しますが、ジオメトリを実行することはありません。エージェントにジオメトリを生成させる場合（STEP ファイルの計測、パイプラインの実行、板金パーツの展開、glTF への変換など）は、CAD Cloud の API キーを使い、Bitbybit CAD Cloud MCP も接続してください。

claude mcp add --transport http bitbybit-cloud https://api.bitbybit.dev/mcp --header "X-API-Key: <your key>"

Codex では、同じ設定を [mcp_servers.bitbybit-cloud] として記述し、url = "https://api.bitbybit.dev/mcp" および env_http_headers = { "X-API-Key" = "BITBYBIT_API_KEY" } を指定します。キーは環境変数から読み取られます。

この 2 つは連携するように設計されています。エージェントはここでメンバーの情報を取得し、同じドット区切りのパスと同じ引数オブジェクトを使って、あちらでそのメンバーを呼び出します。

ライブラリとして

このパッケージはツールレジストリとインデックスリーダーをエクスポートするため、別のサーバーから同じツールを提供できます。

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) は、通常の HTTP エンドポイント向けに同じツールをレンダリングします。また、guarded(registry, report) は、すべてのサーバーがレジストリに設定するエラー境界です。ハンドラーが例外をスローすると、汎用のエラー結果が返され、例外は report に渡されるため、内部メッセージがクライアントに届くことはありません。Registry.map(wrap) は、独自の用途に合わせてすべてのハンドラーを再ラップします。パッケージのルートは Node の組み込みモジュールをインポートしないため、バンドラーを使ってエッジランタイムに組み込めます。ファイルシステムを読み取るローダーとバージョン検出機能は、それぞれ独立した index-loader および installed-version エントリーです。また、ツールスキーマが通る $ref インライナーは、依存関係のない json-schema エントリーです。

プライバシー

stdio サーバーが外部に送信するのは、対応するバージョンのインデックスを取得するための CDN へのリクエスト 1 件だけです。

リンク

リソース	URL
Bitbybit で AI を使用する	https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/intro
このサーバーのドキュメント	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
エージェント型 CAD - ジオメトリを実行する場所	https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/agentic-cad
MCP を利用できないホスト向けのコンテキストファイル	https://learn.bitbybit.dev/learn/using-ai-with-bitbybit/prompt-contexts
GitHub	https://github.com/bitbybit-dev/bitbybit/tree/master/packages/dev/mcp
モノレポ	https://github.com/bitbybit-dev/bitbybit
TypeScript API リファレンス	https://docs.bitbybit.dev

Bitbybit プラットフォーム

NPM パッケージに加えて、Bitbybit では以下を提供しています。

• ビジュアルプログラミングエディター - Rete と Blockly によるドラッグ＆ドロップ式の 3D モデリングに加え、Monaco TypeScript エディターも利用できます。
• CAD Cloud API - Bitbybit のすべてのアルゴリズムを組み合わせる完全なパイプラインを構築できます。各ステップでは、前のステップの出力を参照できます。パラメトリックモデルの生成、STEP から glTF への変換、HTTP 経由の複雑な CAD ワークフローに対応しています。
• Bitbybit Studio - API キーを持つユーザーがモデルを生成し、ファイルを変換し、GUI でパイプラインを構築し、タスクを確認して 3D の結果をプレビューできる、機能が拡充されているビジュアルダッシュボードです。
• Shopify 向け 3D Bits - E コマース向けのインタラクティブな 3D 商品コンフィギュレーターです。
• スクリプトランナー - ウェブサイト上でビジュアルスクリプトを直接実行できます。
• AI コーディングエージェント向けに構築 - このサーバー、ジオメトリを実行するための CAD Cloud MCP、MCP を利用できないアシスタント向けのコンテキストファイルを提供しています。
• ビジネスおよびエンタープライズ - 企業向けのカスタムアプリケーション開発と、当社のマネージドサーバー上で最適化された CAD テナントワークフローの立ち上げを支援します。

プロジェクトを支援する

このパッケージは、オープンソースの Bitbybit エコシステムの一部です。サブスクリプションにより、継続的な開発を支援できます。

⭐ 購読 - Silver または Gold プラン | CAD Cloud の API キーを取得

コミュニティ

• Discord
• YouTube
• LinkedIn
• X（Twitter）
• ブログ

ライセンス

MIT © Bit By Bit Developers