mcp-svelte-docs

A Model Context Protocol (MCP) server that provides efficient access to Svelte documentation with advanced caching, search capabilities, and optimised content delivery. This server integrates directly with Svelte's official documentation, offering both full and compressed variants suitable for different LLM context window sizes.

Features

• 📚 Complete Svelte documentation access through MCP Resources
• 🔍 Advanced search capabilities:
  • Document type filtering (API, Tutorial, Example, Error)
  • Section hierarchy awareness
  • Intelligent relevance scoring based on:
    • Term frequency
    • Section importance
    • Document type relevance
    • Exact phrase matching
  • Context-aware result excerpts
  • Related search suggestions
• 💾 Efficient caching with LibSQL
• 🔄 Automatic content freshness checks
• 📦 Support for package-specific documentation (Svelte, Kit, CLI)
• 📏 Smart content chunking for large documents
• 🗜️ Compressed variants for smaller context windows
• 🏗️ Built on the Model Context Protocol

Configuration

This server requires configuration through your MCP client. Here are examples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

{
    "mcpServers": {
        "svelte-docs": {
            "command": "npx",
            "args": ["-y", "mcp-svelte-docs"],
            "env": {
                "LIBSQL_URL": "file:local.db",
                "LIBSQL_AUTH_TOKEN": "your-auth-token-if-using-remote-db"
            }
        }
    }
}

Claude Desktop with WSL Configuration

For WSL environments, add this to your Claude Desktop configuration:

{
    "mcpServers": {
        "svelte-docs": {
            "command": "wsl.exe",
            "args": [
                "bash",
                "-c",
                "LIBSQL_URL=file:local.db LIBSQL_AUTH_TOKEN=your-token npx -y mcp-svelte-docs"
            ]
        }
    }
}

Environment Variables

The server supports the following environment variables:

• LIBSQL_URL (optional): URL for the LibSQL database. Defaults to file:local.db
• LIBSQL_AUTH_TOKEN (optional): Auth token for remote LibSQL database

API

The server implements both MCP Resources and Tools:

Resources

Access documentation through these URIs:

• svelte-docs://docs/llms.txt - Documentation index
• svelte-docs://docs/llms-full.txt - Complete documentation
• svelte-docs://docs/llms-small.txt - Compressed documentation
• svelte-docs://docs/{package}/llms.txt - Package-specific documentation
  • Supported packages: svelte, kit, cli

Tools

search_docs

Enhanced search functionality with advanced filtering and context awareness.

Parameters:

• query (string, required): Search keywords or natural language query
• doc_type (string, optional): Filter by documentation type
  • Values: 'api', 'tutorial', 'example', 'error', 'all'
  • Default: 'all'
• context (number, optional): Number of surrounding paragraphs (0-3)
  • Default: 1
• include_hierarchy (boolean, optional): Include section hierarchy
  • Default: true

Example Usage:

// API Reference Search
{
  "query": "bind:value directive",
  "doc_type": "api",
  "context": 1
}

// Tutorial Search
{
  "query": "routing sveltekit",
  "doc_type": "tutorial",
  "context": 2,
  "include_hierarchy": true
}

get_next_chunk

Retrieve subsequent chunks of large documents.

Parameters:

• uri (string, required): Document URI
• chunk_number (number, required): Chunk number to retrieve (1-based)

Development

Setup

1. Clone the repository
2. Install dependencies:

pnpm install

3. Build the project:

pnpm build

4. Run in development mode:

pnpm dev

Publishing

1. Update version in package.json
2. Build the project:

pnpm build

3. Publish to npm:

pnpm publish

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Acknowledgments

• Built on the Model Context Protocol
• Powered by Svelte Documentation
• Uses LibSQL for efficient caching