mcp-svelte-docs

这是一个模型上下文协议（MCP）服务器，提供从TypeScript声明中直接提取的权威Svelte 5和SvelteKit定义。通过一个统一的接口获取所有Svelte 5概念的精确语法、参数和示例。

架构

定义优先方法：与多个专用工具不同，此服务器提供了一个强大的svelte_definition工具，访问超过28个全面定义，涵盖：

• 所有Svelte 5符文（$state, $derived, $props, $effect变体）
• 现代功能（代码片段、await表达式、远程函数）
• 事件处理（DOM事件、自定义事件、组件通信）
• 迁移指南（Svelte 4到5模式及最佳实践）
• TypeScript接口（代码片段类型、快照类型）
• 高级模式（全局状态、常见错误、生命周期等价）

可用工具

svelte_definition

单一且强大的工具，适用于所有Svelte 5和SvelteKit概念：

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

示例：

• svelte_definition("$state") - 完整的$state文档
• svelte_definition("snippets", "quick") - 带有示例的代码片段概述
• svelte_definition("onclick", "syntax") - 仅TypeScript签名
• svelte_definition("migration-patterns") - Svelte 4 → 5迁移指南

响应格式：

• "syntax" - 仅TypeScript签名（约50字）
• "quick" - 定义+最小示例（约200字）
• "full" - 带有示例的完整文档（约500-1000字，默认）

可用标识符（28+）

核心符文： $state, $state.raw, $state.snapshot, $derived, $derived.by, $props, $bindable, $effect, $effect.pre, $effect.root, $effect.pending, $effect.tracking

开发工具： $inspect, $host

功能与模式： snippets, onclick, component-events, migration-patterns, await-expressions, remote-functions, global-state, common-mistakes, lifecycle-equivalents

事件处理： custom-events, event-delegation, event-modifiers

TypeScript接口： snippet, snapshot

主要特点

🎯 权威且TypeScript优先

• 直接源自源码：定义从官方Svelte 5 TypeScript声明中提取
• 始终最新：反映实际API，而非过时教程
• 类型安全：包含精确的参数类型、返回值和约束

⚡ 单个接口，全面覆盖

• 一个工具：svelte_definition替代了16+个专用工具
• 28+定义：涵盖每个Svelte 5符文、功能和模式
• 一致响应：无论需要的是$state还是remote-functions，接口都相同

🚀 现代Svelte 5及SvelteKit支持

• await表达式：模板中的异步操作（await-expressions）
• 远程函数：客户端-服务器间类型安全通信（remote-functions）
• 所有符文：完整的$effect家族、$state变体、$derived.by、$bindable
• 高级模式：事件处理、全局状态、组件通信

📚 智能错误恢复

• 模糊匹配：为拼写错误建议正确的标识符
• 相关概念：搜索失败时指向相似定义
• 迁移帮助：将Svelte 4模式转换为Svelte 5等价物

配置

Claude Desktop（通过WSL）

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

Cursor

Windsurf（通过WSL）

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

Windows（无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"]
		}
	}
}

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT许可证 - 详情见LICENSE文件。

致谢

基于：

• 模型上下文协议
• Svelte