Shadcn MCP Server

A containerized Model Context Protocol (MCP) server that enables AI agents to dynamically install shadcn UI components into a mounted project workspace.

Features

• Standardized MCP Interface: Exposes an add_shadcn_component tool to add shadcn components.

• Dockerized Execution: Run within a clean Docker environment, shielding host dependencies.

• Seamless Volume Mounting: Configured to run npx shadcn@latest add directly inside the mounted host codebase.

• Automated Registry Publishing: Automatically tags and pushes Docker images to GitHub Container Registry (GHCR) via GitHub Actions.

Related MCP server: Shadcn Space MCP

Getting Started

Usage in Docker MCP Toolkit

If your server is published to GitHub Container Registry, users can add it to their local IDE workspace with these steps:

1. Create a local profile:

   docker mcp profile create --name my-project

2. Add the MCP server:

   docker mcp profile server add my-project --server docker://ghcr.io/your-github-username/shadcn-mcp:latest

3. Configure the workspace mount directory:

   docker mcp profile config my-project --set shadcn-mcp.volumes=".:/workspace"

4. Connect the profile to your IDE (VS Code):

   docker mcp client connect vscode --profile my-project

Local Development

1. Install dependencies:

   npm install

2. Build TypeScript:

   npm run build

3. Start the server:

   npm start