{"_id":"@binsarjr/shadcn-svelte-mcp","_rev":"5-692d0200932a915796fb4ff919a7d026","name":"@binsarjr/shadcn-svelte-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@binsarjr/shadcn-svelte-mcp","version":"1.0.0","keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"author":"","license":"MIT","_id":"@binsarjr/shadcn-svelte-mcp@1.0.0","maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"bin":{"shadcn-svelte-mcp":"dist/index.js"},"dist":{"shasum":"14cc69f2982ba6edfec203a0bb784019dfe714f1","tarball":"https://registry.npmjs.org/@binsarjr/shadcn-svelte-mcp/-/shadcn-svelte-mcp-1.0.0.tgz","fileCount":81,"integrity":"sha512-w+itiTpQ7T1kwSL5hJcoktiil6HCG/MkWx+snvlxxSe2hPr34rI87GsL+PwwO/w+Z3oyNCNgN/mIbFohKBMsZg==","signatures":[{"sig":"MEYCIQCKDkGRbBW2bIed2jqbRAVYJ7c3sKFQREAWZ9GxpXKaCwIhAPUThOheNUG4UdNB1s+e7GlrVKSE5No9n91xtdU5vWVq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1414875},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0"},"gitHead":"4d5ea181a13709407b8e8ea595f8fd6ed71f63f7","scripts":{"dev":"bun --watch src/index.ts","build":"tsc && cp -r src/data dist/ && chmod +x dist/index.js","start":"bun src/index.ts","inspect":"bunx @modelcontextprotocol/inspector bun src/index.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"binsarjr","email":"binsarjr121@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.22","typescript":"^5.9.2"},"_npmOperationalInternal":{"tmp":"tmp/shadcn-svelte-mcp_1.0.0_1758114067568_0.7136441182126569","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@binsarjr/shadcn-svelte-mcp","version":"1.0.1","keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"author":"","license":"MIT","_id":"@binsarjr/shadcn-svelte-mcp@1.0.1","maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"bin":{"shadcn-svelte-mcp":"dist/index.js"},"dist":{"shasum":"80297fb6ae96f9b613f983463f58771c63517b65","tarball":"https://registry.npmjs.org/@binsarjr/shadcn-svelte-mcp/-/shadcn-svelte-mcp-1.0.1.tgz","fileCount":87,"integrity":"sha512-rZ5vBwAk0R4sK4Uq6iMNxsAUkJaJupm70NNeukSBllfm+YHPawpTXB8ect9/Ul7KZnlPaivWTaV7nqlwx/oXmA==","signatures":[{"sig":"MEQCICLheBe3zaudD/7vKJGCHaRrWv7pFK5Q8dgt51wbclGwAiBs4xUAaw2v3EKZh48NEcEo0wsxELqF0ExlbVWDW/P8Dw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1446000},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0"},"gitHead":"35468d06c070a8a207faa5e0ae7f8d8ec4c2c729","scripts":{"dev":"bun --watch src/index.ts","build":"tsc && cp -r src/data dist/ && chmod +x dist/index.js","start":"bun src/index.ts","inspect":"bunx @modelcontextprotocol/inspector bun src/index.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"binsarjr","email":"binsarjr121@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.22","typescript":"^5.9.2"},"_npmOperationalInternal":{"tmp":"tmp/shadcn-svelte-mcp_1.0.1_1758114950446_0.3528228055216214","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@binsarjr/shadcn-svelte-mcp","version":"1.1.0","keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"author":"","license":"MIT","_id":"@binsarjr/shadcn-svelte-mcp@1.1.0","maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"bin":{"shadcn-svelte-mcp":"dist/index.js"},"dist":{"shasum":"1af95d4e0d034dc3ed56016c5cfb1302fad52477","tarball":"https://registry.npmjs.org/@binsarjr/shadcn-svelte-mcp/-/shadcn-svelte-mcp-1.1.0.tgz","fileCount":65,"integrity":"sha512-hThm4QrsTA/Q3j8q/OXDbM+b9h1gEIP64RVyEkvhMEHF5pgZie/Hyvhql5UbaT8CRMPJOYZuOroacSx4oVvOfg==","signatures":[{"sig":"MEUCIA6F/0adlATHOW96Dor/q3rmzTWKuI3qHCiN2Cn+E4OeAiEAt+J3XENB1Q5r9LZ6qcCUsjfuUYV65UOPg8OJ9aLMnX8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":882453},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0"},"gitHead":"78a7c6d9f1b7292ebbfb3e64132b7bd9d2ac2963","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"tsc && cp -r src/data dist/ && chmod +x dist/index.js","start":"bun src/index.ts","inspect":"bunx @modelcontextprotocol/inspector bun src/index.ts","test:watch":"bun test --watch","test:coverage":"bun test --coverage","prepublishOnly":"bun run build"},"_npmUser":{"name":"binsarjr","email":"binsarjr121@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.22","typescript":"^5.9.2"},"_npmOperationalInternal":{"tmp":"tmp/shadcn-svelte-mcp_1.1.0_1758483925574_0.7335652695499664","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@binsarjr/shadcn-svelte-mcp","version":"1.1.1","keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"author":"","license":"MIT","_id":"@binsarjr/shadcn-svelte-mcp@1.1.1","maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"bin":{"shadcn-svelte-mcp":"dist/index.js"},"dist":{"shasum":"098a0f5b42a6f9c8c6640631860dc1653c15b14a","tarball":"https://registry.npmjs.org/@binsarjr/shadcn-svelte-mcp/-/shadcn-svelte-mcp-1.1.1.tgz","fileCount":42,"integrity":"sha512-F0E9gWnpCozVHraYQnZu+aZ3v1RaT4uN+JbqFE0Nrh5ZI1RhNwB6tIu0cah6r4jgVxn6bS1YxeuUBVti+4SXIg==","signatures":[{"sig":"MEUCIA6BnB4DWdTs5GYXJu9T5C4w14XgJCB7b2nlNzWJgzZsAiEA1l80jD4IcjnOXAWG2z7mB5NA+g5RWy+YTjIc5Y0sP94=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":302742},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0"},"gitHead":"1d4d9c461022e3d31967056fe26665fef6a41a67","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"tsc && cp -r src/data dist/ && chmod +x dist/index.js","start":"bun src/index.ts","inspect":"bunx @modelcontextprotocol/inspector bun src/index.ts","test:watch":"bun test --watch","test:coverage":"bun test --coverage","prepublishOnly":"bun run build"},"_npmUser":{"name":"binsarjr","email":"binsarjr121@gmail.com"},"_npmVersion":"11.3.0","description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.2.22","typescript":"^5.9.2"},"_npmOperationalInternal":{"tmp":"tmp/shadcn-svelte-mcp_1.1.1_1758484380252_0.22971520305309046","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@binsarjr/shadcn-svelte-mcp","version":"1.2.0","description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","type":"module","main":"dist/index.js","bin":{"shadcn-svelte-mcp":"dist/index.js"},"scripts":{"dev":"bun --watch src/index.ts","build":"tsc && cp -r src/data dist/ && chmod +x dist/index.js","start":"bun src/index.ts","test":"bun test","test:watch":"bun test --watch","test:coverage":"bun test --coverage","test:unit":"bun test tests/database.test.ts tests/utils.test.ts tests/server.test.ts","test:integration":"bun test tests/integration.test.ts","test:performance":"bun test tests/integration.test.ts --grep 'performance'","test:specific":"bun test --grep","test:verbose":"bun test --verbose","test:debug":"bun test --inspect","prepublishOnly":"npm run build","inspect":"bunx @modelcontextprotocol/inspector bun src/index.ts"},"keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.18.0","zod":"^3.25.76"},"devDependencies":{"@types/bun":"^1.2.22","typescript":"^5.9.2"},"engines":{"bun":">=1.0.0"},"_id":"@binsarjr/shadcn-svelte-mcp@1.2.0","gitHead":"3b15fec59d6491528a97ad904c950438f80f9187","types":"./dist/index.d.ts","_nodeVersion":"24.2.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-Bdaf5Kpasd6WzMRnGNOS8IIUFem/EKjR11HdSUb+6ZJj4qx+1zNXShkNHC0OiFwohK02FeRE/knU4uyJXtQw4g==","shasum":"266913560ee70d505811126992203c33b18f8480","tarball":"https://registry.npmjs.org/@binsarjr/shadcn-svelte-mcp/-/shadcn-svelte-mcp-1.2.0.tgz","fileCount":58,"unpackedSize":456215,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDwbNVUbZybqIwXP6rL0c/W3cOKLbRCG7rrPtdEdKxFVAIhALP/Zn5szw2lnaZp7kJ+puwjWQDoJsYtTGYfGMh4g+x2"}]},"_npmUser":{"name":"binsarjr","email":"binsarjr121@gmail.com"},"directories":{},"maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/shadcn-svelte-mcp_1.2.0_1758517454771_0.11831546013504868"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-17T13:01:07.431Z","modified":"2025-09-22T05:04:15.164Z","1.0.0":"2025-09-17T13:01:07.781Z","1.0.1":"2025-09-17T13:15:50.675Z","1.1.0":"2025-09-21T19:45:25.813Z","1.1.1":"2025-09-21T19:53:00.438Z","1.2.0":"2025-09-22T05:04:14.986Z"},"license":"MIT","keywords":["mcp","shadcn","svelte","sveltekit","ui","components","typescript","design-system","tailwind","development","assistant"],"description":"MCP server for shadcn-svelte development with curated knowledge, components, and examples","maintainers":[{"name":"binsarjr","email":"binsarjr121@gmail.com"}],"readme":"# shadcn-svelte MCP Server\n\nA specialized Model Context Protocol (MCP) server for shadcn-svelte development, providing curated knowledge, code examples, and intelligent assistance for building modern UI components with design systems, theming, and accessibility best practices in Svelte and SvelteKit applications.\n\n## Features\n\n### 🔍 **Searchable Resources**\n- **Knowledge Base**: Curated Q&A covering shadcn-svelte concepts, patterns, and best practices\n- **Code Examples**: Searchable collection of shadcn-svelte implementation patterns\n\n### 🛠️ **Intelligent Tools**\n- `search_knowledge` - Find explanations and concepts\n- `search_examples` - Discover code patterns and implementations\n- `search_components` - Search UI components with props and variants\n- `generate_component` - Generate components with themes and accessibility\n- `audit_with_rules` - Review code against shadcn-svelte best practices\n- `explain_concept` - Get detailed explanations with examples\n\n### 📝 **Smart Prompts**\n- `generate-component` - Generate modern shadcn-svelte components\n- `audit-shadcn-code` - Audit code for accessibility and design system compliance\n- `explain-concept` - Detailed concept explanations with examples\n- `find-component` - Find specific components with usage patterns\n\n## Installation\n\n### Option 1: Direct usage with bunx (Recommended)\n\nSimply add to your Claude Desktop configuration - no installation required:\n\n```json\n{\n  \"mcpServers\": {\n    \"shadcn-svelte\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@binsarjr/shadcn-svelte-mcp\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Option 2: Manual installation\n\n```bash\n# Clone and setup\ngit clone https://github.com/binsarjr/shadcn-svelte-mcp\ncd shadcn-svelte-mcp\n\n# Install dependencies with Bun\nbun install\n\n# Start the server\nbun start\n```\n\n## Project Structure\n\n```\nshadcn-svelte-mcp/\n├── src/\n│   ├── index.ts                    # Main MCP server implementation\n│   ├── ShadcnSvelteSearchDB.ts   # SQLite database with FTS5 search\n│   └── data/\n│       ├── knowledge/             # Curated Q&A knowledge base (JSONL)\n│       ├── examples/              # Code examples and patterns (JSONL)\n│       └── components/            # Component catalog with props and variants (JSONL)\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n## Usage with Claude Desktop\n\n### Recommended: Using bunx (no installation required)\n\n```json\n{\n  \"mcpServers\": {\n    \"shadcn-svelte\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@binsarjr/shadcn-svelte-mcp\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Alternative: Local installation\n\n```json\n{\n  \"mcpServers\": {\n    \"shadcn-svelte\": {\n      \"command\": \"bun\",\n      \"args\": [\"/path/to/shadcn-svelte-mcp/src/index.ts\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Usage Examples\n\n### 🔍 Search Knowledge\n```\nTool: search_knowledge\nQuery: \"button variants themes\"\n```\n\nReturns detailed explanations about implementing button variants with different themes in shadcn-svelte.\n\n### 📚 Find Code Examples\n```\nTool: search_examples\nQuery: \"card component accessibility\"\n```\n\nReturns working shadcn-svelte card component implementations with accessibility features.\n\n### 🧩 Search Components\n```\nTool: search_components\nQuery: \"dialog modal\"\n```\n\nReturns component details for dialog/modal components with props, variants, and installation instructions.\n\n### 🏗️ Generate Components\n```\nTool: generate_component\nDescription: \"User profile card with avatar, name, and action buttons\"\nComponent Type: \"card\"\nTheme: \"auto\"\n```\n\nGenerates a complete shadcn-svelte component using modern patterns with relevant examples from the knowledge base.\n\n### 🔍 Audit Code\n```\nTool: audit_with_rules\nCode: \"<script>\\n  let { variant = 'default', ...props } = $props();\\n</script>\\n<button class={buttonVariants({ variant })} {...props}><slot /></button>\"\nFocus: \"accessibility\"\n```\n\nAnalyzes code and suggests shadcn-svelte improvements for accessibility compliance and design system consistency.\n\n## Key shadcn-svelte Concepts Covered\n\n### 🎯 **Core shadcn-svelte Features**\n- **Components** - Pre-built, accessible UI components\n- **Themes** - Light/dark mode support with CSS variables\n- **Variants** - Component styling variations using class-variance-authority\n- **Design System** - Consistent color, spacing, and typography tokens\n- **Accessibility** - WCAG-compliant components with proper ARIA attributes\n\n### 🧩 **Svelte Integration**\n- **Component Composition** - Using slots and component patterns\n- **Reactive Patterns** - Svelte's reactivity with shadcn-svelte components\n- **TypeScript Integration** - Proper type definitions and prop typing\n- **SvelteKit Usage** - Server-side rendering and routing integration\n- **Style Management** - Tailwind CSS integration and customization\n\n### 📈 **Advanced Patterns**\n- **Custom Theming** - Creating custom theme configurations\n- **Component Variants** - Advanced styling patterns with cva\n- **Responsive Design** - Mobile-first component implementations\n- **Form Handling** - Form components with validation and accessibility\n- **Animation** - Motion and transition patterns with shadcn-svelte\n\n## Data Format\n\n### Knowledge Base (JSONL files in `data/knowledge/`)\n```json\n{\n  \"question\": \"How do I customize shadcn-svelte button variants?\",\n  \"answer\": \"To customize button variants in shadcn-svelte, you can modify the variants object in your button component using class-variance-authority (cva)...\",\n  \"category\": \"components\",\n  \"tags\": [\"button\", \"variants\", \"customization\"]\n}\n```\n\n### Examples (JSONL files in `data/examples/`)\n```json\n{\n  \"title\": \"Accessible Button with Custom Variants\",\n  \"description\": \"Button component with custom variants and full accessibility support\",\n  \"component\": \"Button\",\n  \"code\": \"<script lang=\\\"ts\\\">\\n  import { cn } from '$lib/utils';\\n  import { buttonVariants } from './variants';\\n  \\n  type Variant = 'default' | 'destructive' | 'outline';\\n  \\n  interface Props {\\n    variant?: Variant;\\n    class?: string;\\n  }\\n  \\n  let { variant = 'default', class: className, ...restProps }: Props = $props();\\n</script>\\n\\n<button \\n  class={cn(buttonVariants({ variant }), className)}\\n  {...restProps}\\n>\\n  <slot />\\n</button>\",\n  \"category\": \"buttons\",\n  \"tags\": [\"button\", \"variants\", \"accessibility\", \"typescript\"],\n  \"complexity\": \"intermediate\",\n  \"dependencies\": [\"class-variance-authority\", \"clsx\"]\n}\n```\n\n### Component Entries (JSONL files in `data/components/`)\n```json\n{\n  \"name\": \"Button\",\n  \"description\": \"Displays a button or a component that looks like a button with various styling variants\",\n  \"category\": \"form\",\n  \"props\": \"{\\\"variant\\\": {\\\"type\\\": \\\"'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link'\\\", \\\"default\\\": \\\"'default'\\\"}, \\\"size\\\": {\\\"type\\\": \\\"'default' | 'sm' | 'lg' | 'icon'\\\", \\\"default\\\": \\\"'default'\\\"}}\",\n  \"usage\": \"<Button variant=\\\"outline\\\" size=\\\"sm\\\">Click me</Button>\",\n  \"installation\": \"npx shadcn-svelte@latest add button\",\n  \"variants\": [\"default\", \"destructive\", \"outline\", \"secondary\", \"ghost\", \"link\"],\n  \"dependencies\": [\"class-variance-authority\", \"clsx\"]\n}\n```\n\n## Configuration\n\n### Database Location\n\nThe server stores its SQLite database following the XDG Base Directory specification:\n\n- **All platforms**: `~/.config/binsarjr/shadcn-svelte-mcp/database.db`\n\nThis provides a consistent, organized location across all operating systems.\n\n### Environment Variables\n\nYou can customize the database location using environment variables:\n\n```json\n{\n  \"mcpServers\": {\n    \"shadcn-svelte\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@binsarjr/shadcn-svelte-mcp\"],\n      \"env\": {\n        \"SHADCN_SVELTE_MCP_CONFIG_DIR\": \"/custom/config/path\",\n        \"SHADCN_SVELTE_MCP_DB_PATH\": \"/custom/database.db\"\n      }\n    }\n  }\n}\n```\n\n### Search Features\n\nThe server uses SQLite with FTS5 for advanced search capabilities:\n\n- **Full-Text Search**: Utilizes SQLite's FTS5 extension for powerful and efficient searching across the knowledge base, examples, and components.\n- **Tokenization**: Employs the `unicode61` tokenizer with a comprehensive set of separators for robust indexing of terms.\n- **Synonym Expansion**: Enhances search recall by automatically expanding query terms with predefined shadcn-svelte-specific synonyms.\n- **Result Highlighting**: Search results include highlighted matches within relevant fields using FTS5's `highlight()` function.\n- **Relevance Ranking**: Results are ordered by relevance based on FTS5's internal ranking algorithm.\n- **Advanced Boosting**: Offers capabilities for custom scoring and boosting to fine-tune search results.\n\n## Development\n\n### Testing\nThe server provides comprehensive logging and error handling:\n\n```bash\n# Test the server\necho '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/list\"}' | bun start\n\n# Test via bunx\necho '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/list\"}' | bunx @binsarjr/shadcn-svelte-mcp\n\n# Enable development mode with watch\nbun run dev\n\n# Inspect the server (for debugging)\nbun run inspect\n```\n\n### Building and Publishing\n\n```bash\n# Build for production\nbun run build\n\n# Publish to npm\nnpm publish\n```\n\n## Contributing\n\n### Adding Knowledge\n1. Add entries to JSONL files in `src/data/knowledge/`\n2. Format: `{\"question\": \"...\", \"answer\": \"...\", \"category\": \"...\", \"tags\": [...]}`\n3. Focus on shadcn-svelte specific features and best practices\n\n### Adding Examples\n1. Add entries to JSONL files in `src/data/examples/`\n2. Format: `{\"title\": \"...\", \"description\": \"...\", \"component\": \"...\", \"code\": \"...\", \"category\": \"...\", \"tags\": [...], \"complexity\": \"...\", \"dependencies\": [...]}`\n3. Include complete, working shadcn-svelte code examples\n\n### Adding Components\n1. Add entries to JSONL files in `src/data/components/`\n2. Format: `{\"name\": \"...\", \"description\": \"...\", \"category\": \"...\", \"props\": \"...\", \"usage\": \"...\", \"installation\": \"...\", \"variants\": [...], \"dependencies\": [...]}`\n3. Document component API, variants, and usage patterns\n\n### Search Optimization\n- Use descriptive, searchable keywords in questions, titles, and descriptions\n- Include alternative phrasings for common concepts\n- Tag examples with relevant feature names (`button`, `theme`, `variant`, etc.)\n\n## Advanced Usage\n\n### Custom Search Queries\nThe search tools support sophisticated queries:\n\n```typescript\n// Search for component patterns\nsearch_examples(\"button variants accessibility\")\n\n// Find theming guidance\nsearch_knowledge(\"dark mode theme customization\")\n\n// Discover specific components\nsearch_components(\"dialog modal overlay\")\n```\n\n### Prompt Chaining\nUse prompts in sequence for complex workflows:\n\n1. `find-component` - Find relevant components\n2. `generate-component` - Create based on patterns\n3. `audit-shadcn-code` - Review and optimize\n\n### Integration Tips\n- **Claude Desktop**: Best for interactive development\n- **API Integration**: Use programmatically for code generation\n- **CI/CD**: Audit code in automated workflows\n- **Documentation**: Generate examples for design system documentation\n\n## Troubleshooting\n\n### Common Issues\n\n**\"No results found\"**\n- Check search terms are relevant to shadcn-svelte\n- Try broader queries first, then narrow down\n- Ensure data files are properly formatted JSONL\n\n**\"Tool not found\"**\n- Check MCP client configuration\n- Review server logs for startup errors\n\n**\"Invalid data format\"**\n- Validate JSONL files (one JSON object per line)\n- Check for syntax errors in JSON objects\n\n**Database/Config Issues**\n- Check if config directory is writable\n- Verify database permissions in the config folder\n- Use `SHADCN_SVELTE_MCP_DB_PATH` environment variable for custom locations\n- Check logs for database initialization messages\n\n### Debugging\n```bash\n# Enable debug logging\nDEBUG=* bun start\n\n# Test database location\nbunx @binsarjr/shadcn-svelte-mcp  # Watch for config path logs\n\n# Check config directory (all platforms)\nls -la ~/.config/binsarjr/shadcn-svelte-mcp/\n```\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Acknowledgments\n\n- Built with [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- Validation with [Zod](https://zod.dev/)\n- Curated shadcn-svelte knowledge from official documentation and community best practices\n- Powered by [shadcn-svelte](https://www.shadcn-svelte.com/), [Svelte](https://svelte.dev/), and [SvelteKit](https://kit.svelte.dev/)","readmeFilename":"README.MD"}