mcp-svelte-docs

mcp-svelte-docs

TypeScript の宣言から直接抽出した、Svelte 5 と SvelteKit の信頼できる定義を提供する Model Context Protocol（MCP）サーバーです。統一された単一のインターフェースを通じて、Svelte 5 のすべての概念について、正確な構文、パラメーター、使用例を取得できます。

アーキテクチャ

定義優先のアプローチ：複数の専門ツールを用意する代わりに、このサーバーは、次の内容を網羅する28以上の包括的な定義にアクセスできる、強力な svelte_definitionツールを1つ提供します。

• すべての Svelte 5 ルーン（$state、$derived、$props、$effect の各バリエーション）
• 最新機能（スニペット、await 式、リモート関数）
• イベント処理（DOM イベント、カスタムイベント、コンポーネント間通信）
• 移行ガイド（Svelte 4 から 5 へのパターンとベストプラクティス）
• TypeScript インターフェース（Snippet、Snapshot 型）
• 高度なパターン（グローバル状態、よくある間違い、ライフサイクル相当の機能）

利用可能なツール

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 を反映しています
• 型安全：正確なパラメーター型、戻り値、制約を含みます

⚡ 単一のインターフェースで幅広くカバー

• 1つのツール：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"]
		}
	}
}

貢献

貢献を歓迎します。お気軽にプルリクエストをお送りください。

ライセンス

MIT ライセンスです。詳細はLICENSEファイルをご覧ください。

謝辞

以下を基盤として構築されています。

• Model Context Protocol
• Svelte