MCP Frontend Tools Server
mcp-frontend-tools
프론트엔드 작업을 위한 참조 Model Context Protocol 서버입니다. 한 번의 설치로 Claude Desktop, Cursor, VS Code, Zed, Continue와 같은 모든 코딩 에이전트가 UI를 직접 보고 조작할 수 있게 됩니다:
axe_audit— 원시 HTML(jsdom 경유) 또는 라이브 URL(Playwright 경유)에 대해 실제axe-core규칙 엔진을 실행합니다. WCAG 영향도별로 그룹화된 위반 사항과 수정 링크를 반환합니다.page_screenshot— 뷰포트 / DPR / 컬러 스킴 /waitForSelector제어 기능을 갖춘, 모든 URL 또는 CSS 선택자에 대한 헤드리스 Chromium PNG 스크린샷을 생성합니다.bundle_budget_check—dist/디렉토리를 탐색하여 gzip(선택적으로 brotli 포함) 크기를 계산하고, 전역 또는 엔트리별 KB 예산을 강제합니다. CI에 즉시 사용 가능한 pass/fail JSON을 반환합니다.design_token_diff— 두 개의 W3C DTCG / Style Dictionary 토큰 파일 간의 구조적 차이를 비교합니다.$type을 인식하여 추가/삭제/변경된 토큰에 대한 메모를 보고합니다.storybook_story_run—iframe.html?id=…를 통해 헤드리스 Chromium에서 단일 Storybook 스토리를 로드하고, 스크린샷을 찍은 뒤 렌더링된 컴포넌트에 대해서만 axe 감사를 실행합니다.scaffold_react_component— 타입이 지정된 React 컴포넌트(함수형 /forwardRef/ 다형성as)와 선택적으로 Vitest 테스트 및 Storybook 스토리를 생성합니다.
모든 도구는 모델이 추론할 수 있는 구조화된 JSON을 반환합니다. 에디터별 맞춤 래퍼가 필요 없습니다.
설치
npm i -g @ashios15/mcp-frontend-tools
# Optional — enables page_screenshot, storybook_story_run, and URL-mode axe_audit
npm i -g playwright
npx playwright install chromiumNode ≥ 20 버전이 필요합니다. Playwright 없이도 서버는 시작되지만, 해당 세 가지 도구를 호출하면 "install playwright" 오류가 명확하게 반환됩니다.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json(또는 Windows 해당 경로)에 추가하세요:
{
"mcpServers": {
"frontend-tools": {
"command": "mcp-frontend-tools"
}
}
}Cursor
설정 → MCP → 새 서버 추가:
{
"frontend-tools": { "command": "mcp-frontend-tools" }
}VS Code (GitHub Copilot 에이전트 모드)
.vscode/mcp.json에 추가하세요:
{
"servers": {
"frontend-tools": { "command": "mcp-frontend-tools" }
}
}MCP Inspector
npx @modelcontextprotocol/inspector mcp-frontend-toolsRelated MCP server: Components Build MCP
도구 참조
axe_audit
{
url?: string; // require playwright
html?: string; // jsdom
tags?: string[]; // default: wcag2a/aa + wcag21aa + wcag22aa + best-practice
selector?: string; // URL mode only
timeoutMs?: number; // default 15000
}impact, help, helpUrl 및 규칙당 최대 5개의 실패 노드 예시와 함께 위반 사항 및 불완전한 규칙을 반환합니다.
page_screenshot
{
url: string;
outPath: string; // absolute; parent dirs auto-created
selector?: string;
fullPage?: boolean;
width?: number; // default 1280
height?: number; // default 800
deviceScaleFactor?: number;// default 2
colorScheme?: "light" | "dark" | "no-preference";
waitForSelector?: string;
timeoutMs?: number;
}bundle_budget_check
{
buildDir: string;
budgetKb?: number; // default 250 (gzipped)
perEntryBudgetKb?: Record<string, number>;// key = path substring, longest match wins
ext?: string[]; // default [".js",".mjs",".cjs",".css"]
includeBrotli?: boolean;
}모든 파일의 원시 / gzip / brotli 크기, 적용된 예산, status: "pass" | "fail"을 반환합니다.
design_token_diff
{
beforePath: string;
afterPath: string;
ignoreKeys?: string[];
}W3C DTCG 형태($value, $type)를 이해합니다. $로 시작하는 그룹 메타데이터 키는 무시됩니다. 색상 / 치수 변경 사항에는 note가 주석으로 달립니다.
storybook_story_run
{
storybookUrl: string; // e.g. http://localhost:6006
storyId: string; // e.g. components-button--primary
screenshotPath?: string;
runAxe?: boolean; // default true
viewport?: { width: number; height: number };
colorScheme?: "light" | "dark" | "no-preference";
timeoutMs?: number;
}${storybookUrl}/iframe.html?viewMode=story&id=${storyId}를 로드하고 #storybook-root를 기다린 후, 페이지 오류와 해당 스토리에 범위가 지정된 axe 위반 사항을 보고합니다.
scaffold_react_component
{
name: string; // PascalCase
outDir: string; // absolute
variant?: "functional" | "forwardRef" | "polymorphic";
withTests?: boolean; // default true
withStory?: boolean; // default true
props?: Array<{ name: string; type: string; required?: boolean; defaultValue?: string }>;
}왜 임시 스크립트 대신 이 도구인가요?
에이전트에게 타입이 지정된 계약을 제공합니다. 모든 도구는 모델이 내부를 들여다볼 수 있는 Zod 검증 JSON Schema입니다.
로컬 환각이 없습니다. Axe 위반 사항은 정규식이 아닌 실제 axe-core 엔진에서 나옵니다. 번들 크기는 추정치가 아닌 실제
zlib압축을 통해 계산됩니다.조합 가능합니다.
bundle_budget_check실패 시 → 에이전트에게 가장 큰 파일을page_screenshot으로 가져오도록 요청 → 이미지를 시각적 회귀 단계에 입력합니다. 이 모든 것이 MCP를 통해 이루어집니다.안정적인 인터페이스. 도구는 버전 업데이트 뒤에서 변경되지만, 사용자의
.vscode/mcp.json은 변경되지 않습니다.
개발
git clone https://github.com/ashios15/mcp-frontend-tools.git
cd mcp-frontend-tools
npm install
npm run test # 3 unit tests (bundle + tokens + scaffold)
npm run build
npm run inspector # opens MCP Inspector against the built server
node scripts/smoke.mjs # quick stdio tools/list check라이선스
MIT © ashios15
mcp-frontend-tools
프론트엔드 작업을 위한 참조 Model Context Protocol 서버입니다. 한 번의 설치로 Claude Desktop, Cursor, VS Code, Zed, Continue와 같은 모든 코딩 에이전트가 UI를 직접 보고 조작할 수 있게 됩니다:
axe_audit— 원시 HTML(jsdom 경유) 또는 라이브 URL(Playwright 경유)에 대해 실제axe-core규칙 엔진을 실행합니다. WCAG 영향도별로 그룹화된 위반 사항과 수정 링크를 반환합니다.page_screenshot— 뷰포트 / DPR / 컬러 스킴 /waitForSelector제어 기능을 갖춘, 모든 URL 또는 CSS 선택자에 대한 헤드리스 Chromium PNG 스크린샷을 생성합니다.bundle_budget_check—dist/디렉토리를 탐색하여 gzip(선택적으로 brotli 포함) 크기를 계산하고, 전역 또는 엔트리별 KB 예산을 강제합니다. CI에 즉시 사용 가능한 pass/fail JSON을 반환합니다.design_token_diff— 두 개의 W3C DTCG / Style Dictionary 토큰 파일 간의 구조적 차이를 비교합니다.$type을 인식하여 추가/삭제/변경된 토큰에 대한 메모를 보고합니다.storybook_story_run—iframe.html?id=…를 통해 헤드리스 Chromium에서 단일 Storybook 스토리를 로드하고, 스크린샷을 찍은 뒤 렌더링된 컴포넌트에 대해서만 axe 감사를 실행합니다.scaffold_react_component— 타입이 지정된 React 컴포넌트(함수형 /forwardRef/ 다형성as)와 선택적으로 Vitest 테스트 및 Storybook 스토리를 생성합니다.
모든 도구는 모델이 추론할 수 있는 구조화된 JSON을 반환합니다. 에디터별 맞춤 래퍼가 필요 없습니다.
설치
npm i -g @ashishjoshi/mcp-frontend-tools
# Optional — enables page_screenshot, storybook_story_run, and URL-mode axe_audit
npm i -g playwright
npx playwright install chromiumNode ≥ 20 버전이 필요합니다. Playwright 없이도 서버는 시작되지만, 해당 세 가지 도구를 호출하면 "install playwright" 오류가 명확하게 반환됩니다.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json(또는 Windows 해당 경로)에 추가하세요:
{
"mcpServers": {
"frontend-tools": {
"command": "mcp-frontend-tools"
}
}
}Cursor
설정 → MCP → 새 서버 추가:
{
"frontend-tools": { "command": "mcp-frontend-tools" }
}VS Code (GitHub Copilot 에이전트 모드)
.vscode/mcp.json에 추가하세요:
{
"servers": {
"frontend-tools": { "command": "mcp-frontend-tools" }
}
}MCP Inspector
npx @modelcontextprotocol/inspector mcp-frontend-tools도구 참조
axe_audit
{
url?: string; // require playwright
html?: string; // jsdom
tags?: string[]; // default: wcag2a/aa + wcag21aa + wcag22aa + best-practice
selector?: string; // URL mode only
timeoutMs?: number; // default 15000
}impact, help, helpUrl 및 규칙당 최대 5개의 실패 노드 예시와 함께 위반 사항 및 불완전한 규칙을 반환합니다.
page_screenshot
{
url: string;
outPath: string; // absolute; parent dirs auto-created
selector?: string;
fullPage?: boolean;
width?: number; // default 1280
height?: number; // default 800
deviceScaleFactor?: number;// default 2
colorScheme?: "light" | "dark" | "no-preference";
waitForSelector?: string;
timeoutMs?: number;
}bundle_budget_check
{
buildDir: string;
budgetKb?: number; // default 250 (gzipped)
perEntryBudgetKb?: Record<string, number>;// key = path substring, longest match wins
ext?: string[]; // default [".js",".mjs",".cjs",".css"]
includeBrotli?: boolean;
}모든 파일의 원시 / gzip / brotli 크기, 적용된 예산, status: "pass" | "fail"을 반환합니다.
design_token_diff
{
beforePath: string;
afterPath: string;
ignoreKeys?: string[];
}W3C DTCG 형태($value, $type)를 이해합니다. $로 시작하는 그룹 메타데이터 키는 무시됩니다. 색상 / 치수 변경 사항에는 note가 주석으로 달립니다.
storybook_story_run
{
storybookUrl: string; // e.g. http://localhost:6006
storyId: string; // e.g. components-button--primary
screenshotPath?: string;
runAxe?: boolean; // default true
viewport?: { width: number; height: number };
colorScheme?: "light" | "dark" | "no-preference";
timeoutMs?: number;
}${storybookUrl}/iframe.html?viewMode=story&id=${storyId}를 로드하고 #storybook-root를 기다린 후, 페이지 오류와 해당 스토리에 범위가 지정된 axe 위반 사항을 보고합니다.
scaffold_react_component
{
name: string; // PascalCase
outDir: string; // absolute
variant?: "functional" | "forwardRef" | "polymorphic";
withTests?: boolean; // default true
withStory?: boolean; // default true
props?: Array<{ name: string; type: string; required?: boolean; defaultValue?: string }>;
}왜 임시 스크립트 대신 이 도구인가요?
에이전트에게 타입이 지정된 계약을 제공합니다. 모든 도구는 모델이 내부를 들여다볼 수 있는 Zod 검증 JSON-Schema입니다.
로컬 환각이 없습니다. Axe 위반 사항은 정규식이 아닌 실제 axe-core 엔진에서 나옵니다. 번들 크기는 추정치가 아닌 실제
zlib압축을 통해 계산됩니다.조합 가능합니다.
bundle_budget_check실패 시 → 에이전트에게 가장 큰 파일을page_screenshot으로 가져오도록 요청 → 이미지를 시각적 회귀 단계에 입력합니다. 이 모든 것이 MCP를 통해 이루어집니다.안정적인 인터페이스. 도구는 버전 업데이트 뒤에서 변경되지만, 사용자의
.vscode/mcp.json은 변경되지 않습니다.
개발
npm install
npm run test # 3 unit tests (bundle + tokens + scaffold)
npm run build
npm run inspector # opens MCP Inspector against the built server
node scripts/smoke.mjs # quick stdio tools/list check라이선스
MIT © Ashish Joshi
MCP Frontend Tools Server
AI 어시스턴트(Claude, Copilot, Cursor)에게 프론트엔드 개발 도구(컴포넌트 스캐폴딩, 번들 분석, 접근성 검사, 반응형 디자인 가이드)에 대한 액세스를 제공하는 Model Context Protocol (MCP) 서버입니다.
사용 가능한 도구
도구 | 설명 |
| 테스트, 스토리, CSS 모듈이 포함된 타입 지정 React 컴포넌트 생성 |
| 빌드 디렉토리에서 용량이 큰 JS/CSS를 스캔하고 결과 보고 |
| HTML에 대한 정적 WCAG 2.2 검사 및 수정 제안 |
| 반응형 CSS, 컨테이너 쿼리 및 Tailwind 패턴 생성 |
설정
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:
{
"mcpServers": {
"frontend-tools": {
"command": "node",
"args": ["/path/to/mcp-frontend-tools/dist/index.js"]
}
}
}VS Code with Copilot
.vscode/settings.json에 추가하세요:
{
"github.copilot.chat.mcpServers": {
"frontend-tools": {
"command": "node",
"args": ["${workspaceFolder}/mcp-frontend-tools/dist/index.js"]
}
}
}사용 예시 (AI 채팅)
"아바타, 이름, 바이오 props를 가진 UserProfileCard 컴포넌트를 스캐폴딩해줘"
AI가 scaffold_react_component를 호출하여 다음을 반환합니다:
UserProfileCard.tsx— forwardRef가 포함된 타입 지정 컴포넌트UserProfileCard.test.tsx— Testing Library 테스트UserProfileCard.stories.tsx— Storybook 스토리UserProfileCard.module.css— CSS 모듈index.ts— 배럴 익스포트
"dist/ 폴더의 번들 크기 문제를 분석해줘"
AI가 analyze_bundle을 호출하여 용량이 큰 파일, 권장 사항, 요약 테이블이 포함된 마크다운 보고서를 반환합니다.
아키텍처
src/
├── index.ts # MCP server setup (stdio transport)
└── tools/
├── index.ts # Tool definitions + router
├── scaffold-component.ts # React component generator
├── bundle-analyzer.ts # Build output analyzer
├── a11y-checker.ts # Static WCAG checks
└── responsive-guide.ts # Responsive CSS pattern generator개발
npm install
npm run build
npm run inspector # Test with MCP Inspector라이선스
MIT
Available Tools
6 toolsaxe_auditaxe-core Accessibility AuditA
Run the axe-core accessibility ruleset against an HTML string (jsdom) or a live URL (Playwright). Returns violations grouped by impact with fix guidance and helpUrl links.
Inputs: url, html, tags, selector, +1 more.
bundle_budget_checkBundle Budget CheckA
Walk a build directory, measure raw + gzip (+ optional brotli) sizes per file, and flag files that exceed a global or per-entry KB budget. CI-friendly JSON output.
Inputs: buildDir (required), budgetKb, perEntryBudgetKb, ext, +1 more.
design_token_diffDesign Token DiffA
Diff two design-token JSON files (W3C DTCG / Style Dictionary style). Reports added, removed, and changed tokens with $type-aware classification. Useful for PR review of design-system changes.
Inputs: beforePath (required), afterPath (required), ignoreKeys.
page_screenshotPage Screenshot (Playwright)A
Launch headless Chromium, navigate to a URL, and save a PNG screenshot. Supports element selectors, full-page capture, dark mode, and custom viewports. Requires the optional playwright peer dependency.
Inputs: url (required), outPath (required), selector, fullPage, +6 more.
scaffold_react_componentScaffold React ComponentB
Write a TypeScript React component, optional test, and optional Storybook story into outDir. Supports functional, forwardRef, and polymorphic (as prop) variants.
Inputs: name (required), outDir (required), variant, withTests, +2 more.
storybook_story_runStorybook Story RunA
Load a single Storybook story in headless Chromium via iframe.html, optionally screenshot it, and run an axe-core audit against the rendered output. Requires playwright.
Inputs: storybookUrl (required), storyId (required), screenshotPath, runAxe, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct frontend concern: accessibility auditing, bundle sizing, design token diffs, page screenshots, component scaffolding, and Storybook testing. No two tools could be confused.
All tool names follow a consistent 'object_action' or 'domain_action' pattern with lowercase underscores (e.g., axe_audit, design_token_diff). No mixing of conventions.
Six tools is an appropriate size for a frontend utility toolkit. Each tool provides a distinct, useful function without being overwhelming or too sparse.
The set covers key frontend tasks: accessibility, performance, design tokens, component generation, and testing. A minor gap is the lack of a linting or formatting tool, but the surface is coherent for its scope.
Maintenance
Related MCP Connectors
Live React design-system APIs, patterns, and code validation so AI agents build real UI, not slop.
Run accessibility, contrast, and design token audits and file QA issues from your AI coding tool.
Design systems your AI agent builds with and you reshape, plus standalone React components.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides AI assistants with advanced frontend debugging capabilities through 36 specialized tools for inspecting React/Vue/Angular/Svelte applications. Uses Playwright browser automation and source map intelligence to analyze components, network requests, bundle optimization, and resolve production errors.-
- AlicenseBqualityDmaintenanceProvides AI assistants with tools to grade, generate, and validate UI components against the components.build specification. Supports searching documentation, checking compliance, and generating framework-agnostic accessible components.1124 npmApache 2.0
- AlicenseAqualityDmaintenanceProvides Figma integration, accessibility auditing, and React code generation tools.8MIT
- AlicenseNot gradedqualityBmaintenanceProvides AI-powered UI design, repo intelligence, and frontend code generation tools, enabling assistants to scaffold projects, generate and modify UI components, manage design tokens, and analyze repositories.MIT