orca-profiles-mcp

OrcaSlicer 프로필을 읽고 편집하는 MCP 서버입니다. 전체 inherits 체인을 확장하고 어떤 링크가 각 값을 설정했는지 보여줍니다.

기능

OrcaSlicer 프로필은 부모 프로필과의 차이점만 저장합니다. 파일을 연다고 해서 외벽 속도를 알 수 있는 것은 아닙니다. 값은 부모, 부모의 부모, 또는 엔진의 기본 제공 값에서 올 수 있기 때문입니다. 이 서버는 체인을 루트까지 따라가며 유효 값을 계산하고 그 출처를 유지합니다.

단순한 판독기를 깨뜨리는 Orca의 부분들을 처리합니다:

• 부모는 이름으로, 벤더를 넘어 확인됩니다 — Sovol 필라멘트는 OrcaFilamentLibrary에서 상속됩니다.

• 누락된 Generic … 부모는 Generic <material> @System으로 대체되며, 이름이 바뀐 프로필은 renamed_from 목록을 통해 찾습니다.

• 압출기 변형에 바인딩된 벡터는 요소별로 병합되며, "여기서는 부모의 값을 유지"를 의미하는 nil 마커도 포함됩니다.

• 자식 프로필은 부모보다 더 많은 압출기를 선언할 수 있습니다 — 단일 압출기 머신 프로필 위의 툴체인저 — 이 경우 두 압출기 모두 값을 유지합니다.

• 프로필 유형에 속하지 않는 키는 Orca에서도 버리기 때문에 함께 버려집니다. 이들은 조용히 적용되지 않고 보고됩니다.

설정

cd ~/job/orca-profiles-mcp
uv sync

Claude Code에 등록:

claude mcp add orca-profiles -- uv --directory ~/job/orca-profiles-mcp run orca-profiles-mcp

도구

값은 파일에 저장된 그대로 반환됩니다. "0.20"은 "0.20"으로 유지되고, "100%"는 백분율로 유지됩니다. 엔진은 슬라이스할 때 둘 다 정규화하지만, 이 서버는 그렇게 하지 않으므로 읽은 내용이 프로필의 명시 내용이며, 다시 기록되는 내용도 변경되지 않습니다.

프로필 작성

자신의 프로필은 자유롭게 편집할 수 있습니다. 시스템 프로필이나 번들 프로필을 건드리려면 force=true가 필요합니다. 해당 파일은 벤더 라이브러리에 속하며, 다음 프로필 업데이트가 이를 복원하고, 모든 하위 프로필이 그 변경을 상속합니다.

쓰기는 임시 파일과 원자적 이름 변경을 거치므로, 중단된 쓰기로 인해 프로필이 잘리지 않으며 먼저 파일 옆에 백업 사본이 만들어집니다 (backup=false로 비활성화). 값은 아무것도 기록하기 전에 검사됩니다 — 다른 프로필 유형에 속하는 키, 엔진이 스칼라를 원하는 벡터, 또는 형식이 문자열을 요구하는 숫자는 저장되어 Orca가 조용히 버리지 않고 거부됩니다. 고정된 스냅샷이 인식하지 못하는 설정은 그대로 전달되므로, 최신 Orca로 작성된 프로필도 설정을 잃지 않습니다.

OrcaSlicer는 시작 시 프로필을 읽고 종료 시 다시 씁니다. 애플리케이션이 실행되는 동안 이루어진 편집은 덮어써질 것입니다 — Orca를 먼저 닫으세요.

정확성 확인 방법

Orca의 CLI는 상속을 검증할 수 없습니다. --export-settings는 엔진 기본값과 전달된 파일에 있는 키를 반환하며 inherits를 절대 탐색하지 않습니다. OrcaSlicer.conf를 통해 프리셋을 선택해도 활성화되지 않습니다. 전체 체인을 파일 목록으로 전달하면 중복 구성 파일로 거부됩니다. 세 가지 모두 2.4.2에서 시도되었습니다.

Orca가 남기는 것은 자체 확장의 증거입니다. 사용자 프로필을 저장할 때 완전히 확장된 부모에 대한 최소 델타를 저장합니다. 따라서 Orca가 작성한 모든 프로필은 기록된 답변입니다. check_deltas는 해당 델타를 다시 계산해 비교합니다 — 불일치는 리졸버가 부모를 엔진과 다르게 확장한다는 뜻입니다.

이것이 tests/test_smoke.py가 설치된 라이브러리에 대해 단언하는 내용이며, 툴체인저 벡터 결함이 발견된 방식입니다.

엔진 스냅샷 새로 고침

엔진 기본값, 변형 키 집합, 유형별 키 목록은 설치된 Orca에서 src/orca_profiles_mcp/data/engine-snapshot.json으로 캡처되며, 해당 버전 태그에 고정됩니다. OrcaSlicer를 업그레이드한 후:

uv run python scripts/build_snapshot.py
uv run pytest

테스트

uv run pytest

네 계층:

• 단위 테스트는 미니어처 픽스처 라이브러리에 대해 수행되며, 각 엣지 케이스마다 하나씩 — 벤더 간 상속, Generic 대체, renamed_from, 순환, 부모 없음, stride-1 및 stride-2 벡터, nil 요소;

• 쓰기 왕복: 읽기 → 변경 없이 쓰기 → 파일이 바이트 단위로 동일함;

• 엔드 투 엔드 테스트는 패키징된 진입점을 하위 프로세스로 생성하고 MCP stdio를 통해 구동하며, 도구 등록, 전체 생성/편집/검증/삭제 주기, 오류 전파를 다룹니다;

• 설치된 라이브러리에 대한 검사 — 위에서 설명한 델타 검증 포함.

실제 라이브러리를 사용하는 테스트는 Orca 데이터 디렉터리가 없으면 자체적으로 건너뜁니다. 나머지 모든 것은 픽스처를 대상으로 실행됩니다.

문서

• 설계: docs/specs/2026-08-17-orca-profiles-mcp-design.md — OrcaSlicer 소스를 읽으면서 프로필 형식에 대해 확립된 내용과 CLI 실험이 배제한 내용을 포함합니다.

• 구현 계획: docs/plans/2026-08-17-orca-profiles-mcp.md

라이선스

AGPL-3.0, OrcaSlicer 자체와 동일합니다. 이 프로젝트는 OrcaSlicer 코드를 포함하지 않지만, 상속 로직은 Preset.cpp와 PrintConfig.cpp의 줄 단위 포팅이며, 엔진 스냅샷은 해당 소스에서 추출한 기본값과 키 목록을 담고 있습니다.

OrcaSlicer 프로젝트와 제휴하거나 보증하지 않습니다.