RO

robertcoop/openscad-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

167 stars 21 forks 品質 84 トレンド 25MIT

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

  • OpenSCAD installed on your system
  • uv (recommended) or Python 3.10+

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)
GitHub で README 全文を見る

インストール

uvx openscad-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "openscad": { "command": "uvx", "args": ["openscad-mcp"], "env": { "OPENSCAD_PATH": "/usr/bin/openscad" } } } }