krds-a11y-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_componentsA | 사용 가능한 KRDS 컴포넌트 43종의 색인을 반환한다. 각 줄은 id·이름, 필수 입력 수, 그것을 채우는 필드명(필드:), 변형 이름(변형:)을 담는다 — get_component의 componentId·inputs·variant에 그대로 쓴다. 페이지 전체를 만들 때는 이 도구보다 get_page_scaffold를 먼저 부른다. 마크업은 get_component, 요건만은 get_requirements. 반환: 마크다운 목록 한 장. |
| get_componentA | KRDS 컴포넌트 하나의 마크업과 접근성 요건을 반환한다. 필수 입력(레이블·대체 텍스트 등)을 inputs에 채워야 마크업을 준다 — 비우면 isError 응답으로 채울 필드명과 입력 예시를 안내하니, 그대로 채워 다시 부른다. breadcrumb·pagination·radio_button·checkbox·text_input·select는 입력값을 넣은 마크업을 만들어 주고, 나머지는 킷 원본과 채워 넣을 값을 준다. 페이지 전체 뼈대는 get_page_scaffold, 요건만 볼 때는 get_requirements, id·변형·필드명 목록은 list_components. 반환: 마크다운 — 마크업, 보장 항목, 페이지에서 따로 확인할 항목, 조립 지침, 킷 동작(상태 클래스·초기화), 필요하면 아이콘 교정 CSS. |
| get_page_scaffoldA | KRDS 페이지의 시작 골격을 반환한다. 새 페이지를 만들 때 get_component보다 먼저 부른다. pattern을 주면 공식 KRDS 패턴을 접근성 교정한 완성 템플릿을 주고(apply-complete, apply-detail, apply-form, apply-issue, apply-list, board-detail, board-list, login-id, login-select, login-tabs, main-portal, search-results, sub-page), 없으면 빈 뼈대를 준다. 로그인·신청·검색·게시판 같은 정형 화면은 반드시 pattern을 쓴다 — 레이아웃을 직접 창작하지 않는 것이 KRDS 준수의 기본이다. withSiteChrome: true면 정부 배너·헤더·푸터까지 조립한다. 본문 부품은 get_component로 채운다. 필수 입력(pageTitle, 패턴의 필수 슬롯)이 비면 isError 응답으로 채울 값을 안내한다. 반환: 마크다운 — 페이지 HTML(또는 include 조각), 교정 내역, 조립 지침. |
| get_requirementsA | 마크업 없이 컴포넌트 하나의 접근성 요건만 조회한다 — 필수 입력(필드명·규칙), 보장 항목과 근거, 페이지 수준으로 위임되는 항목, 아직 판정되지 않은 질문. 코드 리뷰·설계 검토용이다. 마크업이 필요하면 get_component를 부른다. 반환: 마크다운. |
| validate_pageA | 조립·변환이 끝난 페이지를 실제 브라우저로 열어 KWCAG 2.2 기준으로 재검사한다. axe-core 전수 실행을 KWCAG 33항목으로 번역하고, 보류된 명도 대비는 직접 실측하며, 수동 확인이 필요한 항목은 확인 절차와 함께 명시한다 — 자동 판정은 접근성 이슈의 일부이므로 이 도구의 통과가 심사 통과를 뜻하지 않는다. 템플릿을 프레임워크로 변환한 뒤, 페이지를 조립한 뒤, 콘텐츠를 채운 뒤에 호출하라. url(dev 서버·배포본) 또는 filePath(로컬 HTML)를 권장한다 — 상대 경로 자산이 그대로 해석된다. 파일을 쓴다: outDir(기본 reports/) 아래 화면별 폴더에 리포트(md)·원시 데이터(json)·스크린샷 2장을 남기고 SUMMARY.md를 갱신한다. keepRuns를 주면 보존 개수를 넘은 이전 검사 기록을 지운다. 이 기록을 Stop 훅과 gate 명령이 읽어 작업 종료를 판정한다. 요소 하나의 색·배치·폰트만 확인할 때는 inspect_page를 쓴다. 반환: 마크다운 — 결론 한 줄(위반 수·검사 무효·공통부 누락), 직전 대비, KRDS 사용 문제, 리소스 오류, 산출물 경로, 리포트 전문. |
| get_icon_fix_cssA | 킷 v1.1.0 npm판의 아이콘 경로 버그(img/img 중복, 206곳 404)를 페이지 전체 범위로 교정하는 CSS를 반환한다. get_page_scaffold(withSiteChrome)를 쓰면 자동 주입되므로 필요 없다. 레이아웃을 직접 구성하는 프로젝트(React 레이아웃 등)에서 아이콘이 안 보일 때, 빠진 곳을 한 개씩 손으로 고치지 말고 이 전체본을 받아 교정 파일로 저장하라. 컴포넌트 하나에 필요한 부분은 get_component 응답에도 들어 있다. 반환: 저장·로드 방법과 CSS 코드 블록. |
| get_framework_guideA | React·Next.js에서 킷을 쓸 때의 충돌(킷 JS는 DOMContentLoaded 1회 init·클라이언트 라우팅 모름)과 실사용 검증된 처방을 반환한다. 킷 위젯(탭·아코디언·GNB)이 SPA에서 동작하지 않으면 자체 해법을 발명하기 전에 이 가이드를 먼저 보라. 위젯별 상태 클래스·초기화 함수는 get_component의 '킷 동작' 절에 있다. 반환: 마크다운 — 충돌 원인과 처방(코드 포함). framework 없이 부르면 고를 수 있는 목록. |
| get_tokensA | 킷 디자인 토큰(색·간격·글자 크기 등 CSS 커스텀 프로퍼티)을 조회한다. var() 참조는 실제 값(hex 등)까지 풀어서 준다. 커스텀 CSS에서 색·크기가 필요하면 임의 값 대신 여기서 토큰을 찾아 var()로 쓰라 — 명도 대비 등 접근성 보장이 토큰에 내장돼 있다. query 없이 부르면 분류 안내를 준다. 반환: 토큰 이름·값·풀린 실제 값 목록(최대 80개). |
| inspect_pageA | 렌더된 페이지에서 요소의 계산 스타일(색·배경·폰트·크기·배치·margin·padding·gap)과 폰트 적용 여부를 읽는다. '이 요소가 무슨 색인가', '폰트가 진짜 적용됐나(시스템 폰트 폴백인가)', '어디에 배치됐나'를 확인할 때 임시 playwright 스크립트를 만들지 말고 이 도구를 쓴다. 파일을 쓰지 않는다. 접근성 판정(위반·KWCAG 항목)은 validate_page를 쓴다. 반환: 마크다운 — 문서 제목, 본문 폰트 적용 여부, 셀렉터마다 배치·색·폰트·간격. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Descriptions actively cross-reference each other to draw boundaries (get_requirements vs get_component for markup, inspect_page vs validate_page for element-level vs page-level checks, list_components vs get_component for index vs detail). The only mild overlap is get_requirements being a subset of get_component's output, but the 'requirements-only for review' framing makes intent clear.
All nine tools use snake_case verb_object naming (list_components, get_tokens, inspect_page, validate_page, get_page_scaffold, get_framework_guide). The verbs are varied but consistently front-loaded, giving a predictable pattern throughout.
Nine tools is well-scoped for a design-system assist server: discovery, detail, requirements, tokens, scaffolding, inspection, validation, and two targeted fix/guide tools. Each tool covers a distinct stage of the build-inspect-validate workflow.
The surface covers the full lifecycle from scaffolding through component assembly, token lookup, runtime inspection, and accessibility validation, plus framework and icon-bug escape hatches. Minor gaps exist (no explicit pattern enumeration or component search beyond list_components), but agents can work around these.