How do I use Font Tools MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Font Tools MCP Check vertical metrics in MyFont.ttf and sync all tables" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Font Tools MCP — 설계 문서

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

설계 원칙

모든 수정은 새 파일로 출력한다. 원본을 절대 덮어쓰지 않는다 (디자이너 워크플로우 보호).
Tool은 작고 명확하게. "테이블 단위" 또는 "메트릭 단위"로 쪼갠다. 거대한 만능 도구를 만들지 않는다.
읽기/쓰기 분리. get_* / list_* 류는 사이드이펙트 없음. set_* / apply_* 는 반드시 output_path 파라미터 강제.
구조화된 반환. 에이전트가 다음 액션을 결정할 수 있도록 항상 JSON dict/list 반환. 자유 텍스트 X.
검증을 도구화. 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 installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Font Tools MCP