Skip to main content
Glama
Master CSS MCP

Master CSS MCP

Official
README.md
<br>
<div align="center">

<p align="center">
  <a href="https://youtu.be/lQLEHN-AiBw">
    <img alt="Watch the Master CSS 2.0 film on YouTube" src="https://i.ytimg.com/vi/lQLEHN-AiBw/maxresdefault.jpg" width="100%">
  </a>
  <br>
  <sub>▶ <a href="https://youtu.be/lQLEHN-AiBw">Watch the Master CSS 2.0 film</a></sub>
</p>

<p align="center">
  <a aria-label="Star Master CSS on GitHub" href="https://github.com/master-co/css">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/stars/master-co/css?color=212022&labelColor=212022&label=star&style=for-the-badge&logo=github&logoColor=fff">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/stars/master-co/css?color=f6f7f8&labelColor=f6f7f8&label=star&style=for-the-badge&logo=github&logoColor=%23000">
      <img alt="GitHub stars" src="https://img.shields.io/github/stars/master-co/css?color=f6f7f8&labelColor=f6f7f8&label=star&style=for-the-badge&logo=github">
    </picture>
  </a>
  <a aria-label="GitHub release (latest by date including pre-releases)" href="https://github.com/master-co/css/releases">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=212022&label=&style=for-the-badge&logo=github&logoColor=fff">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github&logoColor=%23000">
      <img alt="GitHub release" src="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github">
    </picture>
  </a>
  <a aria-label="NPM Package" href="https://www.npmjs.com/package/@master/css">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/dm/@master/css?color=212022&label=%20&logo=npm&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/npm/dm/@master/css?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
      <img alt="NPM package ( download / month )" src="https://img.shields.io/npm/dm/@master/css?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
    </picture>
  </a>
  <a aria-label="JSDelivr" href="https://www.jsdelivr.com/package/npm/@master/css">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=212022&label=%20&logo=jsdelivr&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=f6f7f8&label=%20&logo=jsdelivr&style=for-the-badge">
      <img alt="JSDelivr hits (npm scoped)" src="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=f6f7f8&label=%20&logo=jsdelivr&style=for-the-badge">
    </picture>
  </a>
  <a aria-label="Follow @mastercorg" href="https://twitter.com/mastercorg">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=212022&logo=twitter&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
      <img alt="Follow @mastercorg" src="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
    </picture>
  </a>
  <a aria-label="Github Actions" href="https://github.com/master-co/css/actions/workflows/release.yml">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=212022&logo=githubactions&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
      <img alt="Github release actions" src="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
    </picture>
  </a>
</p>

</div>

## Getting started

- Check out our [homepage](https://css.master.co/).
- Read the [installation guide](https://css.master.co/guide/installation) to set up Master CSS for an application.

## MCP server

This repository also contains the Master CSS [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server, published as [`@master/css-mcp`](https://www.npmjs.com/package/@master/css-mcp) and listed in the MCP Registry as `io.github.master-co/master-css`. Its source lives in [`packages/mcp`](https://github.com/master-co/css/tree/main/packages/mcp). It is built on the official [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) (`@modelcontextprotocol/sdk`) and runs over stdio.

```json
{
  "mcpServers": {
    "master-css": {
      "command": "npx",
      "args": ["-y", "@master/css-mcp@latest", "--root", "/absolute/path/to/project"]
    }
  }
}
```

- **Tools** — inspect, trace and suggest classes; render and compare generated CSS; audit setup, query the manifest and inspect CSS-first directives; lint files or buffers; preview fixes before `mastercss_apply_preview` writes them.
- **Resources** — `mastercss://workspace/manifest`, `mastercss://workspace/entries` and `mastercss://workspace/packages`.
- **Prompts** — `debug-missing-css`, `review-mastercss-classes` and `migrate-to-mastercss`.

See the [MCP server README](https://github.com/master-co/css/blob/main/packages/mcp/README.md) for every tool and the [MCP guide](https://css.master.co/guide/ai-coding#connect-the-mcp-server) for client setup.

## Community

- [Documentation](https://css.master.co/guide/installation) — Set up Master CSS and look up supported behavior.
- [GitHub Discussions](https://github.com/master-co/css/discussions) — Ask questions, discuss ideas, and share your work. English and Chinese are welcome.
- [GitHub Issues](https://github.com/master-co/css/issues) — Report reproducible bugs and track implementation work.
- [Releases](https://github.com/master-co/css/releases) — Follow version changes and release notes.

Use Discussions for technical support so answers remain available to other users. [Discord](https://discord.com/invite/sZNKpAAAw6) remains a secondary community space; real-time support is not guaranteed. See the [support guide](https://github.com/master-co/css/blob/rc/.github/SUPPORT.md).

Our [Code of Conduct](https://github.com/master-co/css/blob/rc/.github/CODE_OF_CONDUCT.md) applies to all Master CSS community channels.

## Contributing
Please see our [CONTRIBUTING](https://github.com/master-co/css/blob/rc/.github/CONTRIBUTING.md) for workflow.

## Inspiration
Some of the core concepts and designs are inspired by these giants.
- The concept of enhanced syntax is inspired by [SASS](https://sass-lang.com/) and [TypeScript](https://www.typescriptlang.org/)
- The concept of Virtual CSS is inspired by the [Virtual DOM](https://reactjs.org/docs/faq-internals.html)
- CSS-first theme configuration and the `@theme` directive are inspired by [Tailwind CSS](https://tailwindcss.com/docs/theme).

## License

Master CSS software, reusable examples, and the public skill are licensed under
the [MIT License](LICENSE). The [website copyright notice](https://github.com/master-co/css/blob/main/site/LICENSE) covers
the site's original implementation, prose, illustrations, and brand assets.
Code samples provided for reuse and copies of MIT-licensed software remain MIT.

TDQS

B3.4/5.0

Scored across 17 tools

Disambiguation4/5

Most tools target clearly distinct phases such as scanning, extracting, linting, inspecting, tracing, rendering, and previewing. There is some potential confusion between paired tools like lint_content vs lint_project, suggest_syntax vs suggest_classes, inspect_class vs trace_class, and scan_project vs extract_classes, but the descriptions generally clarify scope and input type.

Naming Consistency5/5

All tools share the mastercss_ prefix and use snake_case names with predictable verb-oriented phrasing such as lint_content, scan_project, inspect_class, render_css, and apply_preview. The pattern is consistent enough that an agent can infer naming conventions for related operations.

Tool Count4/5

At 17 tools the surface is slightly heavy, but the domain is broad CSS tooling covering setup, scanning, linting, inspection, tracing, rendering, manifests, comparison, and preview application. Each tool appears to earn its place rather than being redundant filler.

Completeness5/5

The set covers the full workflow from workspace setup audit and project scanning through extraction, linting, suggestions, class inspection, tracing, manifest queries, CSS rendering, comparison, and preview/apply safety. There are no obvious lifecycle dead ends for a Master CSS analysis and language-service server.

Maintenance

ActivityActive
ResponsivenessUsually handled