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
• 🔍 Text search with basic relevance scoring (occurrence count, position, and section weighting)
• 💾 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

Search documentation using text matching with basic relevance scoring.

Parameters:

• query (string, required): Search query text
• limit (number, optional): Maximum results to return (1-20, default: 5)

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.

Roadmap

• 🧠 Semantic search implementation using embeddings stored in LibSQL

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