Tailwind Svelte Assistant MCP-Server | PlugMCP
Zum Inhalt springen Verzeichnis Produkt Ressourcen Pricing Vom Herausgeber
Dokumentation Tailwind Svelte Assistant MCP Server
A secure, high-performance Model Context Protocol (MCP) server that provides complete SvelteKit and Tailwind CSS documentation (100% coverage) and code snippets with enhanced security, proper TypeScript implementation, and comprehensive error handling.
MCP server providing SvelteKit + Tailwind CSS documentation, Catalyst UI kit, security hardening, and caching for AI assistants
Beliebiges Tool in beliebigen Agenten. MCP-Verzeichnis für Leute, die keine Server schreiben.
Produkt
Verzeichnis
Entwickler
Unternehmen
—
✨ What's New (v0.1.1)
📚 Complete Documentation Coverage
100% Svelte/SvelteKit Coverage : Official LLM-optimized documentation (1.04 MB)
100% Tailwind CSS Coverage : Complete documentation via Repomix extraction (2.1 MB, 249 files)
Intelligent Search : Search within complete documentation with context
12.5x-25x Improvement : From 4-8% coverage to 100% coverage
🚀 Key Improvements (v0.1.1)
🔒 Security Enhancements
Path Traversal Protection : Comprehensive input sanitization prevents directory traversal attacks
Input Validation : Strict parameter validation with pattern matching and length limits
Secure File Operations : Bounded file access with path validation and size limits
Audit Logging : Structured security event logging for monitoring
🏗️ Architecture Improvements
Modular Design : Separated concerns into dedicated services and utilities
TypeScript Excellence : Full type safety with proper interfaces and no any types
ES Modules : Modern JavaScript module system with proper imports
Error Handling : Comprehensive error classification and safe error messaging
⚡ Performance Optimizations
Content Caching : LRU cache with configurable timeout for improved response times
File Size Limits : Prevents resource exhaustion with configurable limits
Async Operations : Non-blocking file operations for better concurrency
Memory Management : Automatic cache cleanup and garbage collection
📁 Project Structure src/
├── index.ts # Main server with security hardening
├── types.ts # TypeScript type definitions
├── services/
│ └── fileService.ts # Secure file operations with caching
└── utils/
├── security.ts # Input validation and path sanitization
└── errorHandler.ts # Comprehensive error handling
🚀 Quick Start
Install via Smithery (Recommended) The easiest way to install this MCP server is through Smithery :
npx -y @smithery/cli install @CaullenOmdahl/tailwind-svelte-assistant --client claude
Install the server
Configure it for Claude Desktop
Set up all required dependencies
Install via Direct URL For other MCP clients, use the direct server URL:
https://server.smithery.ai/@CaullenOmdahl/tailwind-svelte-assistant/mcp
Add this to your MCP client configuration:
{
"mcpServers": {
"tailwind-svelte-assistant": {
"url": "https://server.smithery.ai/@CaullenOmdahl/tailwind-svelte-assistant/mcp",
"transport": "http"
}
}
}
🛠️ Manual Installation & Setup
Prerequisites
Node.js 20+ (required for ES modules support and dependencies)
npm or yarn
Git (for cloning repository)
Install Dependencies
Build the Server
Development Mode
🔧 Configuration The server uses secure defaults but can be configured via the ServerConfig interface:
const CONFIG: ServerConfig = {
maxFileSize: 3 * 1024 * 1024, // 3MB max file size (for full docs)
cacheTimeout: 5 * 60 * 1000, // 5 minutes cache timeout
contentBasePath: './content',
svelteFullDocsPath: './content/docs/svelte-sveltekit-full.txt',
tailwindFullDocsPath: './content/docs/tailwind-docs-full.txt',
// ... other paths
};
Documentation Updates Documentation is automatically downloaded and updated:
# Update all documentation (Svelte + Tailwind)
npm run update-content
Downloads official Svelte LLM-optimized docs (svelte.dev/llms-full.txt)
Extracts complete Tailwind docs from GitHub via Repomix
Updates component snippet timestamps
Generates content summary
Svelte/SvelteKit: Official LLM-optimized text file (100% coverage)
Tailwind CSS: GitHub repository via Repomix extraction (249 MDX files)
Snippets: Local curated component examples (43 files)
🛡️ Security Features
Input Validation
Pattern Matching : Only alphanumeric, hyphens, underscores, and dots allowed
Length Limits : Configurable maximum input lengths
Path Sanitization : Removes directory traversal attempts
Bounds Checking : Ensures file access stays within allowed directories
Error Handling
Safe Error Messages : No sensitive information exposed to clients
Structured Logging : JSON-formatted audit logs for security monitoring
Error Classification : Different handling for different error types
Graceful Degradation : Fallback responses for non-critical failures
File System Security
Path Validation : Verifies resolved paths are within base directories
File Size Limits : Prevents resource exhaustion attacks
Read-Only Operations : No write operations exposed to clients
Cache Isolation : Content caching doesn't expose file system structure
📊 Performance Features
Caching System // Automatic content caching with configurable timeout
const fileService = new SecureFileService(
1024 * 1024, // Max file size
5 * 60 * 1000 // Cache timeout (5 minutes)
);
Resource Management
Memory Limits : File size restrictions prevent memory exhaustion
Cache Cleanup : Automatic removal of expired cache entries
Async I/O : Non-blocking file operations
Error Recovery : Graceful handling of resource limitations
🔍 Available Tools
🆕 Complete Documentation Tools (Recommended)
get_svelte_full_docs - Get complete Svelte & SvelteKit documentation (1MB, 100% coverage)
No parameters required
Returns entire documentation in single LLM-optimized file
Official format from Svelte team
get_tailwind_full_docs - Get complete Tailwind CSS documentation (2.1MB, 100% coverage)
No parameters required
Includes all 249 documentation files
All utility classes and concepts covered
search_svelte_docs - Search within Svelte/SvelteKit documentation
Parameters: query (string), limit (optional, default: 5)
Returns matching sections with surrounding context
Fast in-memory search
search_tailwind_docs - Search within Tailwind CSS documentation
Parameters: query (string), limit (optional, default: 5)
Returns matching sections with surrounding context
Covers all utility classes
Legacy Documentation Tools
Note : These tools only cover ~4-8% of available documentation. Use the full docs tools above for complete coverage.
get_sveltekit_doc - Retrieve specific SvelteKit documentation topic
get_tailwind_info - Get specific Tailwind CSS information
list_sveltekit_topics - List available SvelteKit docs (limited)
list_tailwind_info_topics - List Tailwind documentation (limited)
Component Tools
get_component_snippet - Fetch Svelte component code
list_snippet_categories - List component categories
list_snippets_in_category - List snippets in category
Enhanced Tool Schemas
Pattern validation with regex constraints
Length limits for input parameters
Comprehensive descriptions with usage examples
Security-hardened input sanitization
📝 Usage Examples
MCP Client Configuration Option 1: Smithery Hosted (Recommended)
{
"mcpServers": {
"tailwind-svelte-assistant": {
"url": "https://server.smithery.ai/@CaullenOmdahl/tailwind-svelte-assistant/mcp",
"transport": "http"
}
}
}
Option 2: Local Installation
{
"mcpServers": {
"tailwind-svelte-assistant": {
"command": "node",
"args": ["./dist/index.js"],
"env": {}
}
}
}
Tool Usage
Recommended: Complete Documentation // Get complete Svelte/SvelteKit documentation (1MB, 100% coverage)
await client.callTool("get_svelte_full_docs", {});
// Get complete Tailwind CSS documentation (2.1MB, 100% coverage)
await client.callTool("get_tailwind_full_docs", {});
// Search within Svelte documentation
await client.callTool("search_svelte_docs", {
query: "load function",
limit: 5 // optional
});
// Search within Tailwind documentation
await client.callTool("search_tailwind_docs", {
query: "padding utilities",
limit: 3 // optional
});
Legacy: Specific Topics (Limited Coverage) // Get specific SvelteKit topic (only covers ~8% of docs)
await client.callTool("get_sveltekit_doc", { topic: "routing" });
// Get specific Tailwind info (only covers ~4% of docs)
await client.callTool("get_tailwind_info", { query: "padding" });
// List available topics (limited)
await client.callTool("list_tailwind_info_topics", {});
Component Snippets // Get a component snippet
await client.callTool("get_component_snippet", {
component_category: "headers",
snippet_name: "navbar-default"
});
// List snippet categories
await client.callTool("list_snippet_categories", {});
🧪 Testing & Quality Assurance
Security Auditing
Dependency Checking
MCP Inspector
🐳 Docker Deployment The included Dockerfile provides a secure, multi-stage build:
# Multi-stage build with security hardening
FROM node:18-alpine AS builder
# ... build process
FROM node:18-alpine AS release
# ... production setup with non-root user
Security Features
Multi-stage build reduces attack surface
Alpine Linux for minimal footprint
Non-root user for container security
Production dependencies only
📈 Monitoring & Logging
Structured Logging All operations are logged with structured JSON for easy parsing:
{
"timestamp": "2024-01-15T10:30:00.000Z",
"level": "info",
"operation": "tool_request",
"tool": "get_sveltekit_doc",
"topic": "routing"
}
Audit Events
Tool requests with parameters
Security violations and blocked requests
Error conditions with classification
Performance metrics and cache hits
🔄 Migration from v0.1.0
Breaking Changes
ES Modules : Updated to use import/export instead of require
TypeScript : Strict typing may require type assertions in some cases
Error Messages : More secure, less detailed error messages
Compatibility
Tool Interface : All existing tools work with improved validation
Content Structure : No changes to content organization
Docker : Updated base image and security hardening
🤝 Contributing
Development Guidelines
Security First : All changes must pass security review
Type Safety : Maintain strict TypeScript compliance
Test Coverage : Include tests for new functionality
Documentation : Update README for any API changes
Code Review Checklist
📚 Documentation
🐛 Troubleshooting
Common Issues # Clear dist and rebuild
rm -rf dist && npm run build
# Ensure executable permissions
chmod +x dist/index.js
Ensure Node.js 18+ for ES module support
Check "type": "module" in package.json
Security Concerns If you discover a security vulnerability, please report it via GitHub issues with the security label.
📄 License This project maintains the same license as the original Tailwind-Svelte-Assistant project.
⚡ Performance Benchmarks
Before vs After (v0.1.1)
Documentation Coverage : 🔴 4-8% → 🟢 100% (12.5x-25x improvement)
Security : 🔴 Critical vulnerabilities → 🟢 Hardened
Type Safety : 🟡 Mixed types → 🟢 Strict TypeScript
Performance : 🟡 No caching → 🟢 5-minute LRU cache
Architecture : 🔴 Monolithic → 🟢 Modular services
Error Handling : 🟡 Basic → 🟢 Comprehensive classification
Documentation Metrics
Svelte/SvelteKit : 1,065,921 bytes (1.04 MB)
Tailwind CSS : 2,197,160 bytes (2.1 MB, 249 files)
Total Tokens : 606,587 tokens (Tailwind)
Update Method : Automated via npm script
Cache Performance
Cold Start : ~50-100ms per file read
Cache Hit : ~1-5ms response time
Memory Usage : ~1-3MB per cached full doc
Cache Efficiency : 80-95% hit rate in typical usage
Search Performance : <10ms for in-memory search
Documentation Sources
Svelte : Official LLM-optimized format from Svelte team
Tailwind : Extracted via Repomix from official GitHub repository
Updates : Automated script with fallback mechanisms
This upgraded MCP server transforms the original prototype into a production-ready service with complete documentation coverage , enterprise-grade security, performance, and maintainability.
Verzeichnis-Score 8/100 Gelistet 10 von 10
In der offiziellen MCP Registry 0 von 18
Vom Maintainer beansprucht 0 von 8
Antwortet mit einer Tool-Liste 0 von 12
GitHub-Sterne 6 von 16
Wöchentliche Downloads 0 von 10
Context7 Context7 Platform -- Up-to-date docs for AI agents Context7 Up-to-date docs for AI agents Emblem # EmblemAI MCP
EmblemAI is a hosted Model Context Protocol server that gives AI agents a full-featured crypto wallet plus **200+ tools** for trading, DeFi, NFTs, and on-chain analytics across **7 blo Openwiki OpenWiki is a CLI that writes and maintains agent documentation for your codebase. Skill Seekers Convert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection Fastapi Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Fastapi Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Registry A community driven registry service for Model Context Protocol (MCP) servers. AWS Docs And Regions A fully managed remote MCP server that provides up-to-date documentation, code samples, knowledge about the regional availability of AWS APIs and CloudFormation resources, and other official AWS conte Multi Carrier Shipping API — Powered By Secureship Secureship MCP gives AI assistants access to a multi-carrier shipping API covering rate comparison, label generation, package tracking, pickup scheduling, address book management, shipment history, cu Pinescript MCP server providing Pine Script v6 documentation for AI assistants.
Enables AI to:
Look up Pine Script functions and validate syntax
Access official documentation for indicators, strategies Context7 Fetch up-to-date, version-specific documentation and code examples directly into your prompts. Enhance your coding experience by eliminating outdated information and hallucinated APIs. Simply add `use MCP-Server für Documentation Die besten MCP-Server für Documentation
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
Wie installiere ich Tailwind Svelte Assistant? Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt Tailwind Svelte Assistant einen API-Schlüssel? In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Welchen Transport verwendet Tailwind Svelte Assistant? Tailwind Svelte Assistant läuft lokal über stdio.
Wann wurde Tailwind Svelte Assistant zuletzt geprüft? Zuletzt geprüft: 2026-10-28. MCP server providing SvelteKit + Tailwind CSS documentation, Catalyst UI kit, security hardening, and caching for AI assistants
Tools haben Beschreibungen 0 von 6
Seit drei Tagen nicht gesehen -8