robertcoop/openscad-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

167 stars 21 forks Качество 84 Тренд 25MIT

Repository Install

Сервер Model Context Protocol (MCP) для 3D-моделирования и рендеринга OpenSCAD

Обзор

Сервер Model Context Protocol (MCP), который даёт ассистентам ИИ возможность рендерить, экспортировать и анализировать 3D-модели с помощью OpenSCAD. Создано на FastMCP для Python. - установлен на вашей системе — (рекомендуется) или Python 3.10+ Используйте флаг --scope, чтобы контролировать, где сохраняется конфигурация: - : ~/Библиотека/Поддержка приложений/Claude/claude_desktop_config.json - : %APPDATA%\Claude\claude_desktop_config.json Добавьте .mcp.json-файл в корень проекта: Каждый ответ инструмента содержит ошибки, предупреждения и подсказки, полученные из вывода OpenSCAD. Проверьте их: OpenSCAD выходит из 0 при неудачном assert() или неизвестном модуле и рисует пустую сцену. Детали подаются в строке как parts=[{name, code, place?, frame?, ghost?, mass_g?, motion?}] или в чек-файле (frames, quality, parts, checks, model). OpenSCAD-MCP Check запускает чек-файл из оболочки с значимым выходным кодом, так что make check — это один вызов.

Обзор (машинный перевод)

Сервер протокола Model Context Protocol (MCP), который позволяет ИИ ассистенты проектируют 3D-печатные детали и сборки в OpenSCAD: рендерить с установленным масштабом, измерять точную геометрию, проверять сборки на наличие интерференции а также зазор, извлечение отверстий и элементов, оценка печати и экспорт. Построено с помощью FastMCP для Python; OpenSCAD 2021.01 — поддерживаемый этаж а снимки разработчиков используются при наличии.

Предварительные требования

OpenSCAD установлен на вашей системе
uv (рекомендуют) или Python 3.10+

Установка

Сервер опубликован в PyPI под позначкой openscad-mcp, то есть uv Запускает его без клона и без виртуальной части: uvx openscad-mcp. UV хранит кэшированный файл копировать; uv tool upgrade openscad-mcp (или uvx openscad-mcp@latest) вытягивает Новый релиз, и uvx [email protected] пинирует один.

Код Клода

Добавьте сервер с помощью одной команды:

Или, если OpenSCAD не на вашем ПУТИ:

Используйте флаг --scope, чтобы контролировать, где сохраняется конфигурация:

Область	Флаг	Эффект
Локальное (по умолчанию)	`--scope local`	Доступно только вам в текущем проекте
Проект	`--scope project`	Передано команде через `.mcp.json`

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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)

Открыть полный README на GitHub

Установка

uvx openscad-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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