# Halo Ds

> Halo Ds is an open-source MCP server for design and media. Props, examples, tokens and page blocks of the Halo React design system for AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web
- **Repository:** https://github.com/halo-design-system/halo-design-system
- **MCP Registry name:** io.github.Halo-design-system/halo-ds
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Halo is an open-source design system with a Figma library and a React library built from the same tokens, in light and dark. The README counts 56 components, 288 design tokens and 42 text styles, plus 8 ready-made blocks and 7 example apps. This MCP server is part of the halo-ds CLI package, so an assistant can look up each component's props, examples and rules instead of guessing.

Tokens are CSS variables prefixed --halo-, theme switching uses a data-theme attribute, and npx halo-ds theme with a hex colour sets the brand colour without a rebuild. The same repository ships a Claude Code plugin with skills to build, review, theme and migrate interfaces, and a Figma plugin for placing components.

Start with npx halo-ds init, then register the server with claude mcp add halo -- npx -y halo-ds mcp. The README gives setup pages for Cursor, VS Code and Windsurf. It is MIT licensed, version 0.6.0.

## Features

- **Component documentation:** Assistants read props, examples and usage rules for each Halo component.
- **Design tokens:** 288 tokens as --halo- CSS variables for light and dark themes.
- **Page blocks:** Eight ready-made blocks and seven example apps to build from.
- **Brand theming:** One CLI command sets a brand colour in both modes.
- **Claude Code plugin:** Skills for building, reviewing, theming and migrating UI.
- **Figma pairing:** Figma library and React components share the same tokens.

## Good for

- Have an assistant build a screen with correct Halo components
- Check generated UI against Halo's tokens and rules
- Retheme an app to a brand colour
- Migrate existing UI to Halo components

## Install

### Claude Code (Terminal)

```sh
claude mcp add halo-ds -- npx -y halo-ds
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "halo-ds": {
      "command": "npx",
      "args": [
        "-y",
        "halo-ds"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "halo-ds": {
      "command": "npx",
      "args": [
        "-y",
        "halo-ds"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "halo-ds": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "halo-ds"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "halo-ds": {
      "command": "npx",
      "args": [
        "-y",
        "halo-ds"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "halo-ds": {
      "command": "npx",
      "args": [
        "-y",
        "halo-ds"
      ]
    }
  }
}
```

## FAQ

### Is Halo free?

Yes, it is MIT licensed.

### How do I add the server to Claude Code?

Run claude mcp add halo -- npx -y halo-ds mcp.

### How do I start a project with Halo?

Run npx halo-ds init, or npm install @halo-ds/react.

### Does it support dark mode?

Yes, set data-theme on the html element to light, dark or system.

### What does it require to develop on?

Node.js 22.12+ and pnpm.

### Is Halo Ds free?

Yes. Halo Ds is open source, so you can use and self-host it for free.

### How do I add Halo Ds to Claude Code?

Run this command in your terminal: claude mcp add halo-ds -- npx -y halo-ds

### What are the best alternatives to Halo Ds?

The closest alternatives to Halo Ds are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/halo-ds
