
robertcoop/openscad-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
OpenSCAD 3Dモデリングおよびレンダリングのためのモデルコンテキストプロトコル(MCP)サーバー
概要
モデルコンテキストプロトコル(MCP)サーバーで、AIアシスタントがOpenSCADを使って3Dモデルをレンダリング、エクスポート、解析する能力を提供します。FastMCPでPythonを用いて構築されました。 - システムにインストールされていること - (推奨)またはPython 3.10+ --scopeフラグを使って、構成の保存場所を制御します: - : ~/ライブラリ/アプリケーションサポート/Claude/claude_desktop_config.json - : %APPDATA%\Claude\claude_desktop_config.json プロジェクトのルートに.mcp.jsonファイルを追加します: すべてのツール応答には、OpenSCADの出力から解析されたエラー、警告、ヒントが伴います。確認してください:OpenSCADは失敗した主張()または未知モジュールで0を終了し、空白のシーンを描画します。 パーツはparts=[{name, code, place?, frame?, ghost?, mass_g?, motion?}]としてインラインで提供されるか、チェックファイル(frames, quality, parts, checks, model)として提供されます。OpenScad-MCPのチェックは、意味のある終了コードを持つシェルからチェックファイルを実行するため、Make checkは1回の呼び出しです。
概要(AI 翻訳)
AIを可能にするモデルコンテキストプロトコル(MCP)サーバー アシスタントはOpenSCADで3Dプリント可能な部品やアセンブリを設計します: 指定されたスケールでレンダリングし、正確な幾何学を測定し、アセンブリの干渉をチェックします クリアランス、穴や特徴の抽出、印刷性の判断、輸出。ビルド Python用のFastMCP;OpenSCAD 2021.01がサポートされているフロアです 開発者のスナップショットは存在する場合に使用されます。
前提条件
- OpenSCAD があなたのシステムにインストールされています
- uv(推奨)またはPython 3.10+
設置
サーバーはPyPI上でopenscad-mcpとして公開されているので、uv
クローンもvirtualenvも使わず実行します:uvx openscad-mcp。UVはキャッシュを保持します。
コピー;uv tool upgrade openscad-mcp(またはuvx openscad-mcp@latest)が
新作リリース、そしてuvx [email protected]がピン1。
クロード・コード
サーバーは1つのコマンドで追加できます:
あるいは、OpenSCADがあなたのPATHにない場合:
--scope フラグを使って構成の保存場所を制御します:
| 範囲 | 旗 | 効果 |
|---|---|---|
| ローカル(デフォルト) | --scope local |
現在のプロジェクトであなただけが利用可能 |
| プロジェクト | --scope project |
チームと共有 .mcp.json |
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
OpenSCAD MCP Server
A Model Context Protocol (MCP) server that lets AI assistants design 3D-printable parts and assemblies in OpenSCAD: render with a stated scale, measure exact geometry, check assemblies for interference and clearance, extract holes and features, judge printability, and export. Built with FastMCP for Python; OpenSCAD 2021.01 is the supported floor and dev snapshots are used when present.
Prerequisites
Installation
The server is published on PyPI as openscad-mcp, so uv
runs it with no clone and no virtualenv: uvx openscad-mcp. uv keeps a cached
copy; uv tool upgrade openscad-mcp (or uvx openscad-mcp@latest) pulls a
new release, and uvx [email protected] pins one.
Claude Code
Add the server with a single command:
claude mcp add openscad --transport stdio -- uvx openscad-mcp
Or, if OpenSCAD is not on your PATH:
claude mcp add openscad --transport stdio \
--env OPENSCAD_PATH=/path/to/openscad -- uvx openscad-mcp
Use the --scope flag to control where the configuration is saved:
| Scope | Flag | Effect |
|---|---|---|
| Local (default) | --scope local |
Available only to you in the current project |
| Project | --scope project |
Shared with the team via .mcp.json |
| User | --scope user |
Available to you across all projects |
The repository is also a Claude Code plugin (skill plus server):
/plugin marketplace add robertcoop/openscad-mcp then
/plugin install openscad-mcp@openscad-mcp.
Claude Desktop
Add to your configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openscad": {
"command": "uvx",
"args": ["openscad-mcp"],
"env": {
"OPENSCAD_PATH": "/usr/bin/openscad"
}
}
}
}
Then restart Claude Desktop.
Cursor / Windsurf / VS Code
Add a .mcp.json file to your project root:
{
"mcpServers": {
"openscad": {
"command": "uvx",
"args": ["openscad-mcp"]
}
}
}
Manual / Standalone
# From PyPI (no install required)
インストール
uvx openscad-mcp設定
{
"mcpServers": {
"openscad": {
"command": "uvx",
"args": ["openscad-mcp"],
"env": {
"OPENSCAD_PATH": "/usr/bin/openscad"
}
}
}
}