MotionSpec — web animation accessibility MCP
Web animation accessibility MCP: GSAP, static CSS checks, prefers-reduced-motion, WCAG 2.2.2/2.3.3.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- HIGH
- MEDIUMmotion_catalog에서
- MEDIUMmotion_audit에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"motionspec": {
"command": "npx",
"args": [
"motionspec"
]
}
}
}실행 가능한 패키지
1.2.12stdio원격 엔드포인트
https://api.motionspec.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (5)
🟢motion_catalog
Returns the catalog of verified motion primitives (names, purpose, parameter schemas, defaults) plus the authoring rules for writing a MotionSpec. Call this FIRST, then write the spec yourself, check it with motion_validate and compile it with motion_compile. Free motion check: https://motionspec.dev/motion-check · paid Motion Report (9 USD, one-time): https://motionspec.dev/pricing?src=mcp-motion_catalog#p-report.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢motion_validate(spec)
Checks a MotionSpec against the schema, the primitive allow-list, parameter bounds and injection rules. Fail-closed: returns ok=false with precise errors. Returns {ok, errors, warnings, deprecations, catalogVersion}. IMPORTANT: warnings[] carries the WCAG 2.2.2 / reduced-motion findings and can be non-empty while ok=true — a spec that compiles is not automatically accessible. Use to pre-check a spec before compiling.
입력 스키마
{
"type": "object",
"properties": {
"spec": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "The MotionSpec JSON object"
}
},
"required": [
"spec"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢motion_compile(spec, specName)
Validates (fail-closed) and deterministically compiles a MotionSpec into vanilla-GSAP JavaScript and CSS, with prefers-reduced-motion enabled by default and a performance-budget report. Same spec always yields identical code. Returns {ok:true, js, css, warnings, report, catalogVersion} or {ok:false, errors, catalogVersion}; css may be null when no CSS is emitted. Read warnings before shipping: explicitly disabling reduced-motion or loop pause controls can compile with accessibility warnings. Does not write files or execute the emitted code.
입력 스키마
{
"type": "object",
"properties": {
"spec": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "The MotionSpec JSON object"
},
"specName": {
"description": "Optional name used in the artifact header",
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$"
}
},
"required": [
"spec"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢motion_audit(url)
Static motion-a11y checker: fetches a URL's HTML + linked stylesheets (up to 12 sheets, 2 MB per response, 8 s timeout) and scans the CSS for (1) animation/transition that moves without an effective (cascade-aware) prefers-reduced-motion guard, (2) animated non-transform/opacity properties, (3) infinite animations with no pause path, (4) <marquee>/autoplay >5s. Colour/opacity-only transitions are not motion (WCAG 2.3.3). Uses scoring v2. Same engine and scoring as the free site check at https://motionspec.dev/motion-check. Returns structuredContent {ok, url, status, score, scoring, scoring_doc, findings, groups, summary, badge, disclosures, coverage} plus a Markdown report in text content, or {ok:false, error} with isError:true on failure. Read status first: pages without CSS motion return status 'not-measurable' with score null; runtime motion such as WAAPI/GSAP/WebGL is not audited. Loading indicators are reported as 'review', not as violations; verify them manually. The 'reduced-motion-safe' badge requires a measurable page with zero findings and no detected runtime motion library. Does network I/O (openWorldHint).
입력 스키마
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The page URL to audit (http/https)."
}
},
"required": [
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢motion_stats
Operator telemetry of the hosted service (not your own usage); needs the operator key (header x-motionspec-key). This unauthenticated call returns access information only; it does not compile code, fetch URLs, run an audit or read usage data. Arguments are optional and unused. Returns isError:true with structuredContent {ok:false, error:'KEY_REQUIRED', tool, freeLocalAlternative} and text guidance. For your own local activity use 'npx -p motionspec motion stats' (MIT). It reads this machine's local activity, not hosted usage.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거