Skip to main content
Glama
kiyong2020

Font Tools MCP

by kiyong2020
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Font Tools MCP — 설계 문서

OTF/TTF 폰트를 AI 에이전트(Claude 등)가 대화형으로 진단·수정·검증하기 위한 MCP 서버 1차 스켈레톤.

설계 원칙

  1. 모든 수정은 새 파일로 출력한다. 원본을 절대 덮어쓰지 않는다 (디자이너 워크플로우 보호).

  2. Tool은 작고 명확하게. "테이블 단위" 또는 "메트릭 단위"로 쪼갠다. 거대한 만능 도구를 만들지 않는다.

  3. 읽기/쓰기 분리. get_* / list_* 류는 사이드이펙트 없음. set_* / apply_* 는 반드시 output_path 파라미터 강제.

  4. 구조화된 반환. 에이전트가 다음 액션을 결정할 수 있도록 항상 JSON dict/list 반환. 자유 텍스트 X.

  5. 검증을 도구화. validate_font를 모든 수정 사이클의 끝에 두어 에이전트가 회귀를 자동 감지하게 한다.

Tool 카탈로그

진단 (read-only)

도구

용도

font_info

패밀리·스타일·UPM·테이블 목록·가변 폰트 여부

list_tables

포함된 SFNT 테이블 태그

dump_table_ttx

특정 테이블을 TTX(XML)로 덤프

get_name_records

name 테이블 전체 레코드

get_vertical_metrics

OS/2 + hhea + vhea 수직 메트릭 한 번에

list_features

GSUB/GPOS feature 태그 목록

수정 (write, output_path 필수)

도구

용도

apply_ttx_patch

TTX XML 패치를 병합 (가장 범용적)

set_name_record

name 테이블 레코드 추가/갱신

set_vertical_metrics

수직 메트릭 변경 + sync_all 옵션으로 OS/2·hhea·vhea 일치화

검증

도구

용도

validate_font

fontbakery 실행, 결과를 JSON으로 반환

학습 메모리 (RAG의 단순 버전)

도구

용도

record_case

(증상, 진단, 패치 요약, 테이블) 사례 저장

find_similar_cases

키워드 매칭으로 유사 사례 검색

메모리는 1단계에서는 JSON 파일. 운영에 들어가면 memory.py의 search()만 임베딩 기반(Chroma/Qdrant)으로 교체하면 된다.

전형적인 대화 흐름

사용자: "Glyphs에서 뽑은 NotoSansKR-Bold.otf인데 InDesign에서 윗줄 간격이
        너무 뜬다. 고쳐줘."

에이전트:
 1) find_similar_cases("InDesign 행간 너무 큼")
    → 과거 사례: "OS/2 usWinAscent/Descent가 hhea와 다름" 발견
 2) get_vertical_metrics("...Bold.otf")
    → 실제로 usWinAscent=2400, hhea.ascent=1900 불일치 확인
 3) set_vertical_metrics(
        font_path=..., output_path="..._fixed.otf",
        ascender=1900, descender=-500, sync_all=True)
 4) validate_font("..._fixed.otf")
    → fontbakery 통과
 5) record_case(
        symptom="InDesign 행간 과도",
        diagnosis="OS/2 usWin* 와 hhea 불일치",
        patch_summary="sync_all로 메트릭 통일, USE_TYPO_METRICS 비트 set",
        table_tag="OS/2,hhea")

향후 확장 지점

  • subset_font (pyftsubset 래퍼) — 한자 영역 분리

  • enable_dsig — Windows 서명 자리 확보

  • add_cmap_entry / remove_cmap_entry — PUA·이모지 매핑

  • set_panose / set_unicode_range — OS/2 분류 비트

  • compare_fonts — 두 버전 diff (회귀 추적)

  • render_preview — HarfBuzz로 셰이핑 후 PNG 생성 (시각 회귀)

파일 구성

font-mcp/
├── README.md                         # 이 문서
├── server.py                         # FastMCP 진입점, tool 등록
├── font_ops.py                       # fontTools 래퍼 (실제 동작)
├── memory.py                         # 사례 저장소 (JSON → 추후 벡터 DB)
├── requirements.txt
└── claude_desktop_config.example.json

설치 & 실행

cd font-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# 단독 동작 확인
python server.py

Claude Desktop에 등록하려면 claude_desktop_config.example.json 참조.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors