RO

robertcoop/openscad-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

167 stars 21 forks 품질 84 트렌드 25MIT

OpenSCAD 3D 모델링 및 렌더링을 위한 모델 컨텍스트 프로토콜(MCP) 서버

개요

모델 컨텍스트 프로토콜(MCP) 서버로, AI 어시스턴트가 OpenSCAD를 사용해 3D 모델을 렌더링, 내보내기, 분석할 수 있도록 합니다. 파이썬용 FastMCP로 구축되었습니다. - 시스템에 설치됨 - (권장) 또는 Python 3.10+ --scope 플래그를 사용하여 구성이 저장되는 위치를 제어하세요: - : ~/라이브러리/애플리케이션 지원/Claude/claude_desktop_config.json - : %APPDATA%\Claude\claude_desktop_config.json 프로젝트 루트에 .mcp.json 파일을 추가하세요: 모든 도구 응답에는 OpenSCAD 출력에서 해석된 오류, 경고, 힌트가 포함되어 있습니다. 확인해 보세요: OpenSCAD는 실패한 assert() 또는 알 수 없는 모듈에서 0을 종료하고 빈 장면을 그립니다. 부품은 인라인으로 parts=[{name, code, place?, frame?, ghost?, mass_g?, motion?}] 또는 체크 파일(frames, quality, parts, check, model)로 제공됩니다. OpenScad-MCP 체크는 의미 있는 종료 코드가 포함된 셸에서 체크 파일을 실행하므로 Make check는 한 번의 호출입니다.

개요(AI 번역)

AI가 사용할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다 조수들은 OpenSCAD에서 3D 출력 가능한 부품과 조립체를 설계합니다: 명시된 축척으로 렌더링하고, 정확한 기하학을 측정하며, 조립체에 간섭이 있는지 확인하세요 그리고 클리어런스, 구멍 및 특징 추출, 인쇄 가능성 판단, 그리고 수출 등이 포함됩니다. 제작 파이썬용 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.

클로드 코드

서버 추가는 한 번의 명령어입니다:

또는 OpenSCAD가 당신의 경로에 없다면:

--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" } } } }