MCP 服务器

MCP Svelte Docs Server

启用通过 MCP 协议的向量相似度搜索和 Svelte 文档服务，支持本地缓存和多种 llms.txt 文档格式。

Tools

search_docs

Search Svelte documentation using specific technical terms and concepts. Returns relevant documentation sections with context. Query Guidelines: - Use technical terms found in documentation (e.g., "route parameters", "state management", "lifecycle hooks") - Search for specific features or concepts rather than asking questions - Include relevant package names for targeted results (e.g., "sveltekit", "stores") Example Queries by Category: 1. Svelte 5 Runes: - "state management runes" (finds $state and state management docs) - "derived state calculation" (locates $derived documentation) - "effect lifecycle runes" (finds $effect usage patterns) - "bindable props svelte" (shows $bindable property usage) 2. Component Patterns: - "component lifecycle" (finds lifecycle documentation) - "event handling svelte5" (shows new event handling patterns) - "component state management" (locates state management docs) - "props typescript definition" (finds prop typing information) 3. SvelteKit Features: - "route parameters sveltekit" (finds routing documentation) - "server routes api" (locates API route docs) - "page data loading" (shows data loading patterns) - "form actions sveltekit" (finds form handling docs) 4. Error Documentation: - "missing export error" (finds specific error docs) - "binding validation errors" (locates validation error info) - "lifecycle hook errors" (shows lifecycle-related errors) - "typescript prop errors" (finds prop typing errors) Query Pattern Examples: ❌ "How do I manage state?" → ✅ "state management runes" ❌ "What are lifecycle hooks?" → ✅ "component lifecycle" ❌ "How do I handle events?" → ✅ "event handling svelte5" ❌ "How do I create dynamic routes?" → ✅ "route parameters sveltekit"

get_next_chunk

Retrieve subsequent chunks of large documents

README

mcp-svelte-docs

一个模型上下文协议 (MCP) 服务器，提供对 Svelte 文档的高效访问，具有高级缓存、搜索功能和优化的内容交付。该服务器直接与 Svelte 的官方文档集成，提供完整和压缩两种变体，适用于不同的 LLM 上下文窗口大小。

特性

📚 通过 MCP 资源访问完整的 Svelte 文档
🔍 高级搜索功能：
- 文档类型过滤（API、教程、示例、错误）
- 章节层级结构感知
- 基于以下因素的智能相关性评分：
  - 词频
  - 章节重要性
  - 文档类型相关性
  - 精确短语匹配
- 上下文感知的搜索结果摘要
- 相关搜索建议
💾 使用 LibSQL 进行高效缓存
🔄 自动内容新鲜度检查
📦 支持特定于包的文档（Svelte、Kit、CLI）
📏 针对大型文档的智能内容分块
🗜️ 压缩变体，适用于较小的上下文窗口
🏗️ 构建于模型上下文协议之上

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例：

Cline 配置

将其添加到您的 Cline MCP 设置中：

{
	"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"
			}
		}
	}
}

带有 WSL 的 Claude Desktop 配置

对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：

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

环境变量

服务器支持以下环境变量：

LIBSQL_URL (可选): LibSQL 数据库的 URL。默认为 file:local.db
LIBSQL_AUTH_TOKEN (可选): 远程 LibSQL 数据库的身份验证令牌

API

服务器实现了 MCP 资源和工具：

资源

通过以下 URI 访问文档：

svelte-docs://docs/llms.txt - 文档索引
svelte-docs://docs/llms-full.txt - 完整文档
svelte-docs://docs/llms-small.txt - 压缩文档
svelte-docs://docs/{package}/llms.txt - 特定于包的文档
- 支持的包：svelte, kit, cli

工具

search_docs

增强的搜索功能，具有高级过滤和上下文感知。

参数：

query (字符串, 必需): 搜索关键字或自然语言查询
doc_type (字符串, 可选): 按文档类型过滤
- 值: 'api', 'tutorial', 'example', 'error', 'all'
- 默认值: 'all'
context (数字, 可选): 周围段落的数量 (0-3)
- 默认值: 1
include_hierarchy (布尔值, 可选): 包含章节层级结构
- 默认值: true

用法示例：

// API 参考搜索
{
  "query": "bind:value directive",
  "doc_type": "api",
  "context": 1
}

// 教程搜索
{
  "query": "routing sveltekit",
  "doc_type": "tutorial",
  "context": 2,
  "include_hierarchy": true
}