@inc2734/unitone-css-mcp

MCP server for unitone-css.

This package helps AI coding assistants inspect the repository structure of unitone-css without re-scanning the entire codebase on every task.

Package status

This package is designed to be publishable as a standalone npm package such as @inc2734/unitone-css-mcp.

The intended separation is:

• @inc2734/unitone-css for the framework itself
• @inc2734/unitone-css-mcp for AI assistant integration

That keeps MCP usage optional for framework users.

Available tools

| Tool | Description | | --- | --- | | list_primitives | List available layout primitives under src/layout-primitives. | | get_primitive | Return file-level details for a specific layout primitive. | | list_behaviors | List available behaviors under src/behaviors. | | get_variables | Return Sass variable files and CSS custom property candidates from src/variables and src/settings. |

Initial scope

This server is intentionally narrow.

• It ignores dist.
• It reads the local repository only.
• It does not try to explain design intent beyond what can be derived from the file tree.

Example setup

Local repository usage

Run the server directly from this repository:

node packages/mcp/server.js

Future npm usage

If this package is published to npm, the intended setup is:

npx -y @inc2734/unitone-css-mcp

Claude Code

claude mcp add unitone-css -- node /absolute/path/to/packages/mcp/server.js

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "unitone-css": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/server.js"]
    }
  }
}

VS Code / Copilot

.vscode/mcp.json

{
  "servers": {
    "unitone-css": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/server.js"]
    }
  }
}

If published to npm, the configuration can be simplified to:

{
  "servers": {
    "unitone-css": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inc2734/unitone-css-mcp"]
    }
  }
}

Notes

• Run npm run check inside packages/mcp for a basic syntax check.
• The default repository root is the current working directory.
• You can override the repository root with UNITONE_CSS_ROOT.
• The server is read-only and intentionally ignores dist.