AINDF
Read-only MCP server for one AINDF design-system bundle: look up what it offers, validate screens.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@ai-native-design-framework/kitclaude mcp add aindf -- npx -y @ai-native-design-framework/kit@0.2.1 mcp '<bundle_path>'
{
"mcpServers": {
"aindf": {
"command": "npx",
"args": [
"-y",
"@ai-native-design-framework/kit@0.2.1",
"mcp",
"<bundle_path>"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
"You’re absolutely right, I ignored your design system and hardcoded UI. Again."
— Your AI-Agent
Get started
Add AINDF to my design system and this project. AINDF is at https://github.com/0design/ai-native-design-framework; version 0.2 runs from a clone. Clone it to
<dir>(an absolute path). In my design system's folder, write my design system down likeexamples/demo-ds: the seven 0.2 sources (tokens,taxonomy,slots,applicability,presets,components,bindings) plusaindf.config.json, which lists them (schemas: 0.1 inschemas/, 0.2 inpackages/aindf-kit/schema/0.2). From that folder runnode <dir>/packages/aindf-kit/src/cli.mjs check aindf.config.jsonuntil it passes, thennode <dir>/packages/aindf-kit/src/cli.mjs bundle aindf.config.json --out aindf.bundle.json. Connect the bundle to your agent's MCP settings; in Claude Code runclaude mcp add aindf -- node <dir>/packages/aindf-kit/src/cli.mjs mcp <absolute path>/aindf.bundle.json(or start Claude Code with--plugin-dir <dir>/pluginand set its bundle path); any other agent runs the samenode … mcp …command as a stdio server in its MCP settings. From then on, write screens only as screen configs pinned to that bundle: look up components, slots, modifiers and presets, and callvalidate-screenuntil it passes. Never hardcode a value my design system does not have; when something is missing, tell me instead of writing your own CSS. Do not change the design system without my approval.
Install
The prompt above works from a clone; the kit is also on npm, so you can do the same without one. You need Node.js 20.10 or newer. From your design system's folder:
npx -y @ai-native-design-framework/kit check aindf.config.json
npx -y @ai-native-design-framework/kit bundle aindf.config.json --out aindf.bundle.json
claude mcp add aindf -- npx -y @ai-native-design-framework/kit mcp /absolute/path/to/aindf.bundle.json
The first command checks your design system, the second makes the bundle (one file per version), the third connects it to Claude Code. Any other agent runs the last command as a stdio MCP server.
To give an agent without the plugin the screen-authoring skill, install it with the skills CLI:
npx skills add 0design/ai-native-design-framework
It installs aindf-screen-author, which works through the MCP server connected above.
How it works
your prompt
│
▼
your agent ◀──── MCP ────▶ your design system
│ asks what it offers: components, slots, modifiers, presets
▼
screen config (JSON, pinned to one version of your design system)
│
▼
check ── refused: "Heading has no prop color; …" ──▶ your agent asks you
│ to add it to your
│ passes design system
▼
builder ──▶ a screen built only from your design system
Without AINDF your agent writes HTML and CSS itself and can ignore your design system. With AINDF the screen is a
config, and the check passes only what your design system offers. Fix how a component looks or works in your design
system once, and every screen built from it gets the fix on the next build, once the screens are moved to the new version (aindf repin).
What's in this repo
SPEC.md: the specification.packages/aindf-kit: the check, the builder and the MCP server.plugin: the plugin for Claude Code.examples/demo-ds: a demo design system with three examples you can run.schemasandpatterns: the JSON Schemas of version 0.1 and an example pattern. The 0.2 schemas are inpackages/aindf-kit/schema/0.2.
Contribute
You can improve the spec, the kit or the plugin, or suggest an idea.
- Fork the repository and make a branch.
- Make your change and run the checks:
node --test packages/aindf-kit/test/*.test.mjsandnode examples/demo-ds/examples.mjs. If you change a schema, updateSPEC.mdandpatterns/starter.jsonin the same pull request. - Open a pull request. Changes to the kit, the plugin and the examples are checked automatically.
Have an idea? Open an issue and describe what result you want.
Links
- Specification: SPEC.md
- Error codes: RULES.md
- Demo design system: examples/demo-ds
- For AI agents: build screens only through the design system's MCP. The rules are in the skill.
- License: MIT
Frequently asked questions
What is AINDF?
Read-only MCP server for one AINDF design-system bundle: look up what it offers, validate screens.
How do I install AINDF?
It runs on your machine. In Claude Code: claude mcp add aindf -- npx -y @ai-native-design-framework/kit@0.2.1 mcp '<bundle_path>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does AINDF need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is AINDF open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains AINDF?
It is published by 0design. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.