SvGrid

@svgrid/mcp

SvGrid 公式の Model Context Protocol サーバーです。

ウェブサイト · ドキュメント · 料金

---

Claude Desktop、Claude Code、Cursor、Zed など、MCP 対応のクライアントをこのサーバーに接続すると、モデルは SvGrid に関する正確で、バージョンが固定された情報を回答します。実際のプロパティ名、メソッド名、イベント名に加え、すべてのデモのソースコードが根拠として利用できます。API の幻覚や古いブログ記事に頼ることはありません。

ドキュメントをチャットに貼り付けるより優れている理由。 記憶を頼りにするモデルは、他のグリッドや古いバージョンの情報も学習しているため、もっともらしい SvGrid の API を捏造します。ドキュメントを貼り付ければ一つの質問には役立ちますが、その後はコンテキストウィンドウから外れてしまいます。このサーバーを使えば、現在の API と実際に動作するすべてのデモのソースコードを、インストールしたバージョンに固定したうえで、どの質問にもツール呼び出し一回で利用できます。

公開されるツール

5 つです。tools/list はリクエストごとに送信されるため、ツールの一覧はターンごとに純粋なオーバーヘッドになります。このサーバーは以前、36 個のツールに約 4,710 トークンを費やしていました。そのうち 79％は、多くのセッションで一度も呼び出されない Studio ツールでした。

ツール	用途
svgrid_search	ドキュメント、すべてのデモ、API の情報を一度の呼び出しで検索します。引数なしの場合はインデックスを返します。
svgrid_get	ドキュメントのスラッグ、デモ ID、または api のいずれかを全文取得します。
svgrid_check_code	ファイルを実際の API と Svelte コンパイラーに照らして検証します。
svgrid_preview	列と行から、会話内にライブで操作可能なグリッドを表示します（MCP Apps）。
svgrid_scaffold	Studio：Drizzle スキーマ、サンプル行、または EntitySchema を、実行可能な SvelteKit ファイルに変換します。

ドキュメントとデモはMCP リソース（svgrid://doc/<slug>、svgrid://example/<id>）としても提供され、すぐに実行できるプロンプトも 4 つ用意されています：build_grid、build_sheet、explain_api、review_grid_code。

3.0 より前のツール名も引き続きすべて応答します：search_docs、get_doc、list_examples、get_example_source、list_docs、get_api_reference、check_svgrid_code、introspect_source、scaffold_entity、および 27 個すべての個別の studio_* ツールです。これらは一覧に表示されません。一覧の表示はコンテキストを消費しますが、公開していない名前への応答にはコストがかからないためです。応答形式は 3.0 に準拠します。

svgrid_check_code - 検索サーバーにはできないこと

ドキュメントを読むと、モデルが正解する可能性は 高く なります。これにより、正解かどうかを 検証できる ようになります。 ファイルを渡すと、行番号付きの診断と、それぞれの正確な置き換え内容が返されます。

{
  "ok": false,
  "checkedAgainst": "@svgrid/[email protected]",
  "compiler": "svelte",
  "counts": { "errors": 3, "warnings": 0, "info": 0 },
  "diagnostics": [
    { "rule": "svgrid/renamed-prop", "severity": "error", "line": 24,
      "message": "`rowData` is not a SvGrid prop.", "fix": "Use `data`." },
    { "rule": "svgrid/renamed-column-key", "severity": "error", "line": 10,
      "message": "`accessorKey` is not a SvGrid column key.", "fix": "Use `field`." },
    { "rule": "svelte/legacy-event-directive", "severity": "error", "line": 30,
      "message": "`on:rowClick` never fires: SvGrid dispatches no component events, it takes callback props.",
      "fix": "Use `onRowClick={...}`." }
  ]
}

チェック内容：

• インストール済みのバージョンに照らした、すべての名前。 インポート可能なシンボル、<SvGrid> のプロパティ、ColumnDef のキー、グリッド API のメソッド、テーマのスタイルシートをチェックします。一覧はビルド時にパッケージのソースから生成されるため、パッケージがエクスポートする内容と食い違うことはありません。また、不明な名前がある場合は、実在する最も近い名前を返します。
• パッケージ間の誤り。 @svgrid/enterprise に属するシンボルや、installEnterprise(api) の後にのみ使用できる API メソッドをチェックします。
• Svelte 5 のルール。 runes ファイル内の export let と $:（コンパイラーエラー）、on:／<slot>／createEventDispatcher（非推奨）、そして変更しても再レンダリングが行われない通常の let 配列をチェックします。
• コンパイル済みのファイル。 Svelte コンパイラーを使用できる場合は、まずユーザーのプロジェクト内のもの、次にここに同梱されているものを使い、実際の解析エラーも返します。結果の compiler フィールドには、どちらが実行されたかが示されるため、「エラーなし」を「コンパイルできる」と誤解することはありません。

コードが正しい場合は何も報告しないように調整されています。このリポジトリ内のすべてのデモで 何も報告しない ことを CI テストで確認しています。誤検知する検証ツールは、ないよりも悪いものです。モデルは動作するコードを喜んで「修正」してしまうからです。

Studio：アプリモデルを操作する（エージェントの共同設計者）

studio_* ツールを使うと、エージェントはビジュアルデザイナーが使用するものと同じ検証済みプロジェクトモデルを構築、編集できます。エンティティ、画面、ブロック、コンポーネントの追加、データソースの接続、テーマ、RBAC、認証、型付きデータレイヤー、デプロイ先の設定を行い、実行可能なアプリ一式を生成するか、デザイナーが読み込める studio.config.json をエクスポートできます。すべての編集はモデル独自の関数と validateProject を通じて実行されるため、エージェントが無効なアプリを作成することはありません。

オプトイン方式です。 サーバーの環境変数に SVGRID_MCP_STUDIO=1 または有効な SVGRID_LICENSE_KEY を設定します。ライセンスがないと役に立たないツールのために、他のユーザーがリクエストのたびにコンテキストを消費する必要はありません。

これらのツールと svgrid_scaffold は @svgrid/enterprise 上で動作します。これはオプションの peer 依存関係であり、npx -y @svgrid/mcp ではインストールされません（コールドスタートが二倍になるためです）。プロジェクトに両方をインストールし、ローカルサーバーを実行してください。

npm i -D @svgrid/mcp @svgrid/enterprise
claude mcp add svgrid -- npx svgrid-mcp

ツール	目的
studio_project	new、load、describe、config、capabilities。
studio_apply	エンティティ、画面、ブロック、コンポーネントの順に適用するモデル変更のバッチ。
studio_configure	テーマ、認証、RBAC、テナンシー、データレイヤー、ジョブ、デプロイ先、レイアウトを一度の呼び出しで設定します。
studio_build	validate を実行し、その後、実行可能な SvelteKit アプリ一式を generate します。

一般的なセッション：studio_project（new）→ 画面ごとに studio_apply のバッチを1回実行 → studio_configure → studio_build（generate）→ ファイルを書き込み、svelte-check を実行。

studio_apply は意図的にバッチ処理を行います。変更ごとに1つずつ適用する27個のツールでは、5画面のアプリを作るのに20回以上の往復が必要でした。現在は画面全体を1回の呼び出しで作成でき、失敗時には、どの操作が失敗し、何がすでに適用されたかが報告されます。

実行方法は2つあります

	stdio（このパッケージ）	リモート HTTP
インストール	npx @svgrid/mcp	https://mcp.svgrid.com/mcp
Node が必要	はい	いいえ
svgrid_check_code でコンパイル	はい	静的チェックのみ
Studio の studio_* ツール	はい（オプトイン）	いいえ
オフラインで動作	はい	いいえ

# No install: point any MCP client at the hosted server
claude mcp add --transport http svgrid https://mcp.svgrid.com/mcp

リモートサーバーは https://mcp.svgrid.com/mcp で稼働しており、ドキュメント、 検証、プレビューのツールを提供しています（ソース）。コンパイラの パス、Studio のツールを使いたい場合や、サードパーティのエンドポイントを 経由させたくない場合は stdio を使用してください。

実行

# One-shot via npx (no install)
npx @svgrid/mcp

# Or install globally, then run the bin
npm install -g @svgrid/mcp
svgrid-mcp

サーバーは stdio 経由で MCP と通信します。stdout は JSON-RPC 専用で、 ログは stderr に出力されます。

Claude Desktop に接続

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "svgrid": {
      "command": "npx",
      "args": ["-y", "@svgrid/mcp"]
    }
  }
}

Claude Desktop を再起動して新しいチャットを開くと、上記のツールを利用できます。

Claude Code に接続

claude mcp add svgrid -- npx -y @svgrid/mcp

次に、セッションで /mcp を実行し、svgrid が一覧にあることを確認します。たとえば、 "svgrid を使って、部門ごとにグループ化し、各行にスパークラインを表示するグリッドを作成して" のように依頼すると、モデルはコードを生成する前に関連するデモのソースを取得します。

Cursor / Zed に接続

同じ mcpServers ブロックをエディターの MCP 設定に追加します。

{
  "mcpServers": {
    "svgrid": { "command": "npx", "args": ["-y", "@svgrid/mcp"] }
  }
}

ソースからビルド

cd packages/mcp
pnpm build
node dist/index.js

pnpm build は最初に scripts/build-manifests.mjs を実行します。このスクリプトは ワークスペースから examples/src/demos/*.svelte と docs/**/*.md を読み込み、 それらを src/data.ts にインライン化します。そのため、公開されるパッケージは 完全に自己完結しています。

エンタープライズ機能

Excel と PDF へのエクスポート、ピボットテーブル、カンバンボード、スケジューラー、 スプレッドシート、サーバーサイドの行モデルは、商用製品の @svgrid/enterprise に含まれています。 回答ではその旨を伝えます。svgrid_search の結果に有料のドキュメントまたはデモが含まれる場合は "enterprise": true が付き、有料機能についての質問にはトライアルリンクを含む1行が返されます。 また、修正にパッケージのインストールが必要な場合は、svgrid_check_code がその旨を追加します。 このパッケージはライセンスキーなしで動作し、キーを設定するまでは透かしが表示されます。 30日間のトライアルでは、すべてのデモを ダウンロードでき、30日間のメールサポートを利用できます。

ライセンス

MIT — 無料で実行でき、ライセンスキーは不要です。一部のツールは SvGrid Studio のプロジェクトを生成します。 Studio 自体は商用製品です。svgrid.com/pricing をご覧ください。 MIT ライセンスの @svgrid/grid コアは、あらゆる用途で無料で使用できます。

SvGrid™ および sv-grid™ は jQWidgets Ltd. の商標です。