@empathyds/mcp-server

MCP (Model Context Protocol) server for Empathy DS - enables AI assistants to discover and use Empathy DS Vue components and blocks.

Features

• Component Discovery: List all 60+ Empathy DS components
• Detailed Information: Get props, variants, and usage examples
• Category Filtering: Browse by Forms, Layout, Feedback, Navigation, etc.
• Blocks Support: Pre-built UI patterns (login forms, dashboards)
• Search: Find components by name or description
• Remote Registry: Fetches data from empathyds.com (works anywhere!)

Quick Start

With Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "empathy-ds": {
      "command": "npx",
      "args": ["-y", "@empathyds/mcp-server"]
    }
  }
}

How It Works

The MCP server fetches component data from https://empathyds.com/registry.json:

• Works for anyone using npx @empathyds/mcp-server
• Falls back to local filesystem for development
• Caches registry data for 5 minutes

Available Tools (8 Total)

| Tool | Description | |------|-------------| | getAllComponents | Lists all 60+ components | | getComponent | Gets props, examples for a component | | getComponentsByCategory | Filter by Forms, Layout, Feedback, etc. | | searchComponents | Search by name or description | | getCategories | Lists all 7 categories | | getBlocks | Lists all pre-built UI patterns | | getBlock | Gets details for a specific block | | getUsageGuide | Best practices for Empathy DS |

Publishing to npm

1. Generate the Registry

# From monorepo root
node scripts/generate-registry.js

This creates apps/docs/public/registry.json which gets deployed to empathyds.com.

2. Deploy Docs Site

Deploy your docs to make https://empathyds.com/registry.json accessible.

3. Publish MCP Server

cd packages/mcp-server

# Ensure you're logged in
npm login

# Build
pnpm build

# Publish
npm publish --access public

4. Users Can Now Use It

npx @empathyds/mcp-server

Development

Local Testing

cd packages/mcp-server
pnpm install
pnpm build
pnpm inspect  # Opens MCP Inspector

Local Antigravity Config

For development, use the local path:

{
  "mcpServers": {
    "empathy-ds": {
      "command": "node",
      "args": ["/path/to/eds-mono/packages/mcp-server/dist/server.js"],
      "disabled": false
    }
  }
}

When You Add New Components

| Step | Action | |------|--------| | 1. Add component | Create in packages/empathy-ds/src/components/ui/ | | 2. Add docs | Create apps/docs/components/{name}.md | | 3. Categorize | Update src/lib/categories.ts | | 4. Regenerate | Run node scripts/generate-registry.js | | 5. Redeploy | Deploy docs to update registry.json | | 6. (Optional) | Publish new MCP server version |

Example AI Queries

• "What components does Empathy DS have?"
• "Show me the button variants"
• "Get the Card component props"
• "What form components are available?"
• "Show me the login form block"