MCP Svelte Docs Server

by spences10

27 stars

650 downloads

Not rated

GitHub

About

Enables vector similarity search and serving of Svelte documentation via the MCP protocol, with support for local caching and multiple llms.txt documentation formats.

Details

Author: spences10
Repository: spences10/mcp-svelte-docs
GitHub stars: 27
Downloads: 650
License: MIT License
Categories: Developer Tools, Search, Knowledge Base, AI

- Definitions extracted directly from official Svelte 5 TypeScript declarations.
- Single svelte_definition tool covers 28+ identifiers.
- Supports runes, snippets, event handling, migration guidance, and TypeScript interfaces.
- Response formats: syntax (TypeScript signature), quick (definition + example), full (complete documentation).
- Smart error recovery with fuzzy matching and related concept suggestions.
- Includes migration help from Svelte 4 to Svelte 5.

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name MCP Svelte Docs Server

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 mcp-svelte-docs
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

From the repository

Claude Desktop (via WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "wsl.exe",
			"args": ["bash", "-c", "npx -y mcp-svelte-docs"]
		}
	}
}

Cursor

Windsurf (via WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "wsl.exe",
			"args": ["bash", "-c", "npx -y mcp-svelte-docs"]
		}
	}
}

Windows (without WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "npx",
			"args": ["-y", "mcp-svelte-docs"]
		}
	}
}

macOS / Linux

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "npx",
			"args": ["-y", "mcp-svelte-docs"]
		}
	}
}

`svelte_definition`

Single, powerful tool for all Svelte 5 and SvelteKit concepts. Parameters: identifier (string), format (optional: 'syntax' | 'quick' | 'full').

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp svelte docs server": {
            "env": {},
            "args": [
                "-y",
                "mcp-svelte-docs"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "mcp-svelte-docs"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "mcp-svelte-docs"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "-y",
        "mcp-svelte-docs"
    ],
    "command": "npx"
}

mcp-svelte-docs

A Model Context Protocol (MCP) server providing authoritative Svelte 5
and SvelteKit definitions extracted directly from TypeScript
declarations. Get precise syntax, parameters, and examples for all
Svelte 5 concepts through a single, unified interface.

Architecture

Definition-First Approach: Rather than multiple specialized tools,
this server provides one powerful svelte_definition tool that
accesses 28+ comprehensive definitions covering:

- All Svelte 5 runes ($state, $derived, $props, $effect variants)
- Modern features (snippets, await expressions, remote functions)
- Event handling (DOM events, custom events, component
communication)
- Migration guidance (Svelte 4 to 5 patterns and best practices)
- TypeScript interfaces (Snippet, Snapshot types)
- Advanced patterns (global state, common mistakes, lifecycle
equivalents)

Available Tool

`svelte_definition`

Single, powerful tool for all Svelte 5 and SvelteKit concepts:

svelte_definition(identifier: string, format?: "syntax"|"quick"|"full")

Examples:

- svelte_definition("$state") - Complete $state documentation
- svelte_definition("snippets", "quick") - Snippet overview with
example
- svelte_definition("onclick", "syntax") - Just the TypeScript
signature
- svelte_definition("migration-patterns") - Svelte 4 → 5 migration
guide

Response Formats:

- "syntax" - TypeScript signature only (~50 words)
- "quick" - Definition + minimal example (~200 words)
- "full" - Complete documentation with examples (~500-1000 words,
default)

Available Identifiers (28+)

Core Runes: $state, $state.raw, $state.snapshot, $derived,
$derived.by, $props, $bindable, $effect, $effect.pre,
$effect.root, $effect.pending, $effect.tracking

Development Tools: $inspect, $host

Features & Patterns: snippets, onclick, component-events,
migration-patterns, await-expressions, remote-functions,
global-state, common-mistakes, lifecycle-equivalents

Event Handling: custom-events, event-delegation,
event-modifiers

TypeScript Interfaces: snippet, snapshot

Key Features

🎯 Authoritative & TypeScript-First

- Direct from Source: Definitions extracted from official Svelte 5
TypeScript declarations
- Always Current: Reflects the actual API, not outdated tutorials
- Type-Safe: Includes precise parameter types, return values, and
constraints

⚡ Single Interface, Complete Coverage

- One Tool: svelte_definition replaces 16+ specialized tools
- 28+ Definitions: Every Svelte 5 rune, feature, and pattern
covered
- Consistent Responses: Same interface whether you need $state
or remote-functions

🚀 Modern Svelte 5 & SvelteKit Support

- Await Expressions: Async operations directly in templates
(await-expressions)
- Remote Functions: Type-safe client-server communication
(remote-functions)
- All Runes: Complete $effect family, $state variants,
$derived.by, $bindable
- Advanced Patterns: Event handling, global state, component
communication

📚 Smart Error Recovery

- Fuzzy Matching: Suggests correct identifiers for typos
- Related Concepts: Points to similar definitions when searches
fail
- Migration Help: Converts Svelte 4 patterns to Svelte 5
equivalents

Config

Claude Desktop (via WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "wsl.exe",
			"args": ["bash", "-c", "npx -y mcp-svelte-docs"]
		}
	}
}

Cursor

Windsurf (via WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "wsl.exe",
			"args": ["bash", "-c", "npx -y mcp-svelte-docs"]
		}
	}
}

Windows (without WSL)

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "npx",
			"args": ["-y", "mcp-svelte-docs"]
		}
	}
}

macOS / Linux

{
	"mcpServers": {
		"mcp-svelte-docs": {
			"command": "npx",
			"args": ["-y", "mcp-svelte-docs"]
		}
	}
}

Contributing

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

License

MIT License - see the LICENSE file for details.

Acknowledgments

Built on:

- Model Context Protocol
- Svelte

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

svelte_definition

Claude Desktop / Cursor

Linux

Macos

Windows

mcp-svelte-docs

Architecture

Available Tool

svelte_definition

Available Identifiers (28+)

Key Features

🎯 Authoritative & TypeScript-First

⚡ Single Interface, Complete Coverage

🚀 Modern Svelte 5 & SvelteKit Support

📚 Smart Error Recovery

Config

Contributing

License

Acknowledgments

Install

More like this

Aws Kb Retrieval Server

Memory

Sentry

Github

Brave Search

Git

`svelte_definition`

`svelte_definition`