ucon-tools

tests codecov publish

ucon 차원 분석 엔진을 위한 호스팅 가능한 인터페이스입니다.

ucon-tools란 무엇인가요?

ucon은 Python을 위한 단위 인식 계산 라이브러리입니다. ucon-tools는 이를 다른 시스템(AI 에이전트를 위한 MCP 서버, 웹 서비스를 위한 REST API, 터미널 사용자를 위한 CLI 등)에서 사용할 수 있는 인터페이스로 패키징합니다.

각 인터페이스는 ucon.tools.<interface> 하위에 위치하며 선택적 추가 기능으로 설치할 수 있습니다:

인터페이스	패키지	추가 기능	상태
MCP 서버	`ucon.tools.mcp`	`ucon-tools[mcp]`	사용 가능
REST API	`ucon.tools.rest`	`ucon-tools[rest]`	계획 중
CLI	`ucon.tools.cli`	`ucon-tools[cli]`	계획 중

MCP 서버

MCP 서버는 AI 에이전트(Claude, Cursor 및 기타 MCP 클라이언트)에 차원 검증이 완료된 단위 변환 및 계산 기능을 제공합니다.

Agent: "Convert 5 mcg/kg/min for an 80 kg patient to mL/h. Drug is 400 mg in 250 mL."

  decompose → constraint solver places quantities, auto-bridges mcg→mg and min→h
  compute   → 5 × 80 kg × (60 min/h) × (1 mg/1000 mcg) × (250 mL/400 mg) = 15 mL/h
  validate  → result dimension matches expected unit ✓

설치

pip install ucon-tools[mcp]

Python 3.10 이상이 필요합니다.

구성

Claude Desktop / Claude Code — MCP 구성에 추가하세요:

{
  "mcpServers": {
    "ucon": {
      "command": "uvx",
      "args": ["--from", "ucon-tools[mcp]", "ucon-mcp"]
    }
  }
}

독립 실행형:

ucon-mcp                    # stdio transport (default)
ucon-mcp --transport sse    # SSE transport for remote clients

도구

핵심 — 변환 및 계산:

도구	설명
`convert`	호환되는 단위 간의 값 변환
`compute`	차원 추적을 포함한 다단계 인자-라벨 계산
`decompose`	자연어 또는 구조화된 입력에서 인자 체인 구성
`check_dimensions`	두 단위가 동일한 차원을 공유하는지 확인

탐색 — 단위 시스템 탐색:

도구	설명
`list_units`	사용 가능한 단위 나열 (차원별 필터링 가능)
`list_scales`	SI 십진 및 이진 접두사 나열
`list_dimensions`	사용 가능한 물리적 차원 나열
`list_constants`	물리 상수 나열 (CODATA 2022)
`list_formulas`	등록된 도메인 공식 나열

런타임 확장 — 세션별 단위 및 변환 추가:

도구	설명
`define_unit`	세션용 사용자 지정 단위 등록
`define_conversion`	변환 에지 추가 (선형 또는 아핀)
`define_constant`	사용자 지정 물리 상수 정의
`call_formula`	등록된 차원 타입 공식 호출
`reset_session`	세션에 정의된 모든 단위, 변환 및 상수 초기화

양의 종류 (KOQ) — 의미론적 모호성 제거:

도구	설명
`define_quantity_kind`	모호성 제거를 위한 양의 종류 등록
`declare_computation`	계산 전 예상되는 양의 종류 선언
`validate_result`	결과가 선언된 종류와 일치하는지 검증
`list_quantity_kinds`	등록된 양의 종류 나열
`extend_basis`	확장된 차원 기반 생성
`list_extended_bases`	세션에 정의된 확장 기반 나열

아키텍처

ucon-tools는 인터페이스 계층입니다. 차원 분석을 재구현하지 않으며, 모든 단위 해석, 변환 및 차원 대수 계산을 ucon에 위임합니다. 이 계층이 추가하는 것은 세션 상태, 프로토콜 처리, 오류 제안, 그리고 decompose 제약 조건 해결사 및 KOQ 모호성 제거와 같은 에이전트 지향 기능입니다.

┌───────────────────────────────────────────────────────┐
│                     Clients                           │
│   MCP (Claude, Cursor)  ·  HTTP  ·  Terminal          │
└──────────┬──────────────────┬──────────────┬──────────┘
           │                  │              │
┌──────────▼───┐   ┌──────────▼───┐  ┌───────▼──────┐
│ ucon.tools   │   │ ucon.tools   │  │ ucon.tools   │
│     .mcp     │   │     .rest    │  │     .cli     │
│              │   │              │  │              │
│  sessions    │   │  (planned)   │  │  (planned)   │
│  decompose   │   │              │  │              │
│  KOQ         │   │              │  │              │
│  suggestions │   │              │  │              │
└──────┬───────┘   └──────┬───────┘  └──────┬───────┘
       │                  │                 │
       └──────────────────┼─────────────────┘
                          │ Python imports
               ┌──────────▼──────────┐
               │        ucon         │
               │                     │
               │  Units, Dimensions  │
               │  ConversionGraph    │
               │  Scales, Constants  │
               └─────────────────────┘

개발

make venv                               # Create virtual environment
source .ucon-tools-3.12/bin/activate    # Activate
make test                               # Run tests
make test-all                           # Run across all supported Python versions

로컬에서 MCP 서버 실행하기

make mcp-server                         # Foreground (stdio)
make mcp-server-bg                      # Background
make mcp-server-stop                    # Stop background server

라이선스

AGPL-3.0. LICENSE를 참조하세요.

ucon-mcp

ucon-tools

ucon-tools란 무엇인가요?

MCP 서버

설치

구성

도구

아키텍처

개발

로컬에서 MCP 서버 실행하기

라이선스

Resources

Latest Blog Posts

MCP directory API