
robertcoop/openscad-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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
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"
}
}
}
}