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

Clone the repository
Install dependencies:

pnpm install

Build the project:

pnpm build

Run in development mode:

pnpm dev

Publishing

Update version in package.json
Build the project:

pnpm build

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