ai-factory-extension-shadcn-mcp

An ai-factory extension that bundles the shadcn/ui MCP server for AI coding agents — tools to install and manage shadcn/ui components directly from the agent.

Quick Start

# from a local directory
ai-factory extension add ./ai-factory-extension-shadcn-mcp

# or from a git repo
ai-factory extension add https://github.com/dealenx/ai-factory-extension-shadcn-mcp.git

ai-factory merges the MCP server configs into every agent that supports MCP (Claude Code, Cline, etc.).

What Gets Installed

After installation your agent's MCP configuration will include:

{
  "mcpServers": {
    "shadcn": {
      "command": "npx",
      "args": ["shadcn@latest", "mcp"]
    }
  }
}

Project Structure

ai-factory-extension-shadcn-mcp/
├── extension.json       # Extension manifest (required)
├── mcp/                 # MCP server templates
│   └── shadcn.json      # shadcn/ui MCP server
├── package.json
├── LICENSE
└── README.md

How It Works

extension.json

The manifest declares which MCP servers the extension provides:

{
  "name": "ai-factory-extension-shadcn-mcp",
  "version": "1.0.0",
  "description": "ai-factory extension: shadcn/ui MCP server",
  "mcpServers": [
    {
      "key": "shadcn",
      "template": "./mcp/shadcn.json",
      "instruction": "shadcn/ui MCP: provides tools to install and manage shadcn/ui components"
    }
  ]
}

Field	Description
key	Unique identifier for the server entry in the agent's settings file.
template	Path to a JSON file with the server's command, args, and env.
instruction	Message shown to the user after install (e.g. required env vars).

MCP Templates (mcp/*.json)

Each template follows the standard MCP server format:

mcp/shadcn.json

{
  "command": "npx",
  "args": ["shadcn@latest", "mcp"]
}

Managing the Extension

# List installed extensions
ai-factory extension list

# Remove the extension (cleans up MCP entries from agent configs)
ai-factory extension remove ai-factory-extension-shadcn-mcp

Documentation

• ai-factory Extensions Guide — full reference for extension manifest fields, MCP servers, injections, commands, skills, and agents.

License

MIT