shadcn-svelte-mcp

Mastra MCP server and tooling that provides real-time access to shadcn-svelte component documentation and developer utilities using web scraping.

Production Deployments

Mastra Cloud is the primary deployment: zero cold start, fast tool discovery, and the same toolset over both transports.

[!NOTE] This project follows our Code of Conduct and welcomes contributions! See our Contributing Guidelines for details.

This repository contains a Mastra-based MCP server that provides real-time access to shadcn-svelte component documentation using web scraping. Use it in your AI-powered code editor to get instant access to the latest shadcn-svelte component information directly from the official website.

Table of Contents

• Production Deployments

• Features

• Bits UI Integration

• Observations & Minor UX Suggestions

• Editor Setup

• CLI & Agent Configuration

• Skills.sh Skill

• Verification & Quick Tests

• Available Tools

• Example Usage

• Local Development

• Developer Scripts

• MCP Architecture

• Project Architecture

• Contributing

• License

• Contact

🎉 Features

• ✅ Production deployment on Mastra Cloud
• ✅ Five main MCP tools for comprehensive shadcn-svelte ecosystem support (see 'Available Tools')
• ✅ Bits UI API documentation - Direct access to underlying component library API docs with AI-optimized content
• ✅ Advanced fuzzy search with typo tolerance and intelligent suggestions
• ✅ Lucide Svelte icon search - Browse and search ~1,600 icons (dynamic) with smart filtering
• ✅ Support for all major AI code editors (Cursor, Windsurf, VS Code, Zed, Claude Code, Codex)
• ✅ HTTP and SSE transport protocols
• ✅ Real-time web scraping from shadcn-svelte.com and bits-ui.com

Bits UI Integration

shadcn-svelte components are built on top of Bits UI, the underlying component library that provides the core functionality. This MCP server provides direct access to Bits UI's comprehensive API documentation through AI-optimized content endpoints.

AI-Optimized Content

The bits-ui-get tool fetches content from Bits UI's dedicated /llms.txt endpoints, which provide:

• Structured API reference tables with Property/Type/Description/Details columns
• Clean markdown formatting optimized for AI consumption
• Implementation details and usage examples
• Data attributes and event handlers documentation
• Navigation links to related components

This ensures that AI assistants receive the most relevant and well-structured information for implementing shadcn-svelte components correctly.

🔧 UX

... View full README on GitHub