1. Conduid
  2. Blockchain
  3. Swatchbook
MCP server · Blockchain

Swatchbook

· github.com/unpunnyfuns/swatchbook

Model Context Protocol server for swatchbook — exposes a DTCG project's tokens, axes, and diagnostics to AI agents without running Storybook.

Unclaimed design-systemdesign-tokensstorybookstorybook-addon
InstallView source
37Low

Scored 5 months ago · breakdown

About Swatchbook

Swatchbook is an MCP server in the Blockchain category: model Context Protocol server for swatchbook — exposes a DTCG project's tokens, axes, and diagnostics to AI agents without running Storybook.

Install

Claude Code
claude mcp add swatchbook -- npx -y @unpunnyfuns/swatchbook-mcp
npx
npx -y @unpunnyfuns/swatchbook-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Swatchbook

Powered by Claude · Grounded in docs

I know everything about Swatchbook. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

swatchbook

A Storybook addon and MDX doc blocks for visualising DTCG design tokens.

Built on Terrazzo's parser. Your production build runs Terrazzo's CLI against the same DTCG source; swatchbook reads it too, inside Storybook.

If your stories already style with CSS variables, they pick up the toolbar's axis flips automatically. That's mostly what the tool does.

Documentation · unpunnyfuns.github.io/swatchbook Live Storybook · /storybook

Install

npm install -D @unpunnyfuns/swatchbook-addon

One package pulls the whole React surface — toolbar, preview decorator, MDX doc blocks, ThemeSwitcher, useToken(). See the Quickstart for configuration.

Packages

Package Purpose
@unpunnyfuns/swatchbook-addon Storybook 10 addon. Re-exports the blocks + switcher React surface.
@unpunnyfuns/swatchbook-core Framework-free DTCG loader.
@unpunnyfuns/swatchbook-blocks MDX doc blocks.
@unpunnyfuns/swatchbook-switcher Framework-agnostic axis / preset popover UI.
@unpunnyfuns/swatchbook-integrations Tailwind v4 and CSS-in-JS adapters for the addon.
@unpunnyfuns/swatchbook-mcp Model Context Protocol server for AI agents.

Most consumers only install the addon; the rest travel transitively. Each sub-package is publishable on its own for slice-only use (e.g. the switcher in a Docusaurus navbar).

Development

pnpm workspaces + Turborepo. Node 24. ESM.

pnpm install
pnpm dev                           # apps/storybook on :6006
pnpm turbo run lint typecheck test build

Credits

Parses DTCG tokens through Terrazzo by the Terrazzo team — its parser, resolver evaluation, and alias resolution are the foundation.

License

MIT © unpunnyfuns.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Swatchbook

How do I install Swatchbook?

Run claude mcp add swatchbook -- npx -y @unpunnyfuns/swatchbook-mcp, then add the server to your MCP client's configuration.

Is Swatchbook safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Swatchbook still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.