units-static

고품질 단위 변환 MCP 서버로, 고정 변환 테이블을 사용합니다(네트워크 I/O 없음). meteo-static의 동반 도그푸드 저장소입니다. 이 저장소는 좋은 MCP 기준선입니다 — 도구들은 스키마 명확성 평가에서 좋은 점수를 받도록 설계되었습니다(명확한 이름, 깊은 설명, 엄격한 열거형, 타입화된 출력 스키마).

도구

Related MCP server: gnomon-mcp

설계 목표(평가자 친화적)

• 이름: 소문자, 설명적, 동사 중심(convert_*, list_*, compare_*)

• 설명: 도구를 호출할 시기, 수행 작업, 사용하지 말아야 할 경우

• 입력: 폐쇄형 열거형 / 제약된 필드와 매개변수별 설명

• 출력: Pydantic 모델 → MCP outputSchema 객체(단순 배열 없음)

• 결정적: 정적 계수 테이블; CI 평가에 안전

실행

STDIO(기본)

pip install -r requirements.txt
python src/server.py

Streamable HTTP

pip install -r requirements.txt
python src/server.py --transport http --port 8000

tools/list 내보내기(로컬)

pip install -r requirements.txt
python scripts/export_tools_list.py --output ci/tools-list.json

GitHub Actions

**plugin-federation/actions**의 공유 Actions:

Nexus 파이프라인 설정

임베딩은 이름 + 설명 + 입력 스키마(tool-embedding-report/v1)를 사용합니다. 임베딩 실패는 판정을 실패시키지 않습니다. 유사성 보고서는 Nexus가 등록된 의미 분석 프로필에서 파생하며, 해당 프로필의 profileVersion과 model은 text-embedding-3-small(줄이지 않으면 1536 차원)과 일치합니다. CI는 해당 프로필을 생성할 수 없습니다.

또한 이 저장소를 테넌트 OIDC 신뢰 정책에 등록하고(meteo-static과 동일한 패턴) units-static 전용 도구 소스를 생성하십시오.

상태

• 작동 중 — stdio + streamable HTTP

• 도구 — 구조화된 I/O를 갖춘 6개의 변환 도구

• CI — 하드 실패 게이트가 있는 Plugin Federation Actions