@svgrid/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,82 @@
+SV-GRID-MCP COMMERCIAL LICENSE
+Version 1.0
+
+Copyright (c) 2026 Boyko Markov <boikom@jqwidgets.com>
+Project: @svgrid/mcp
+
+This software is licensed, not sold. Use requires a valid, paid SvGrid
+Pro or Enterprise license. The MCP server bundles SvGrid example
+sources, documentation, and API reference material; redistribution of
+those materials outside this package is not permitted.
+
+------------------------------------------------------------------------
+1. GRANT (with valid SvGrid Pro or Enterprise license)
+------------------------------------------------------------------------
+
+Subject to the Subscriber's compliance with this License and continued
+payment of the applicable license fee, the Author grants the Subscriber
+a non-exclusive, non-transferable, non-sublicensable license to:
+
+  (a) install and run the Software on developer workstations and on
+      build / CI machines belonging to the Subscriber;
+  (b) configure the Software as an MCP server for AI assistants used
+      by the Subscriber's developers;
+  (c) modify the Software for the Subscriber's internal use, provided
+      that all copyright notices and license terms are preserved.
+
+The number of developer seats covered is determined by the
+Subscriber's SvGrid Pro / Enterprise order. A "developer" is any
+individual who uses an AI assistant configured against this MCP
+server while writing or modifying source code that imports
+`@svgrid/grid` or `@svgrid/enterprise`.
+
+------------------------------------------------------------------------
+2. RESTRICTIONS
+------------------------------------------------------------------------
+
+The Subscriber may NOT:
+
+  (a) redistribute the Software as a standalone package, library, or
+      MCP server;
+  (b) sublicense, rent, lease, or sell the Software to third parties;
+  (c) extract the bundled SvGrid example sources, documentation, or
+      API reference material for use outside this package;
+  (d) use the Software to train, fine-tune, or evaluate a third-party
+      model intended for resale or public distribution;
+  (e) use the Software to develop a directly competing data-grid or
+      table component product.
+
+------------------------------------------------------------------------
+3. SUBSCRIPTION AND TERMINATION
+------------------------------------------------------------------------
+
+The license is granted for the term specified in the Subscriber's
+SvGrid Pro or Enterprise order. On non-renewal or material breach of
+Sections 1 or 2, the license terminates automatically and the
+Subscriber must cease all use of the Software and remove it from
+development environments and CI infrastructure.
+
+------------------------------------------------------------------------
+4. WARRANTY DISCLAIMER AND LIABILITY
+------------------------------------------------------------------------
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM USE OF THE SOFTWARE,
+WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE.
+
+The Author's total cumulative liability under this License shall not
+exceed the license fees paid by the Subscriber in the twelve months
+preceding the event giving rise to the claim.
+
+------------------------------------------------------------------------
+5. CONTACT
+------------------------------------------------------------------------
+
+To purchase a license, request a quote, or report unauthorized use,
+contact: boikom@jqwidgets.com
+Pricing: https://sv-grid.dev/pricing
+
+END OF LICENSE

package/README.md

@@ -0,0 +1,80 @@
+# @svgrid/mcp
+
+A Model Context Protocol (MCP) server for [SvGrid](https://sv-grid.github.io/sv-grid/).
+Point an MCP-capable client (Claude Desktop, Claude Code, Cursor, etc.) at
+this server and the model gets accurate, version-pinned answers about
+SvGrid - no hallucinated APIs, no stale blog posts.
+
+## What it exposes
+
+| Tool | Purpose |
+| --- | --- |
+| `list_examples` | All 20 demo ids, titles, blurbs. |
+| `get_example_source` | Full `.svelte` source for a demo by id. |
+| `list_docs` | Every doc page (slug + title). |
+| `get_doc` | Markdown for a single doc by slug. |
+| `search_docs` | Case-insensitive substring search across docs. |
+| `get_api_reference` | Curated public-API surface, grouped by category. |
+
+## Install + run
+
+```bash
+# One-shot via npx (no install)
+npx @svgrid/mcp
+
+# Or install + run
+npm install -g @svgrid/mcp
+@svgrid/mcp
+```
+
+The server speaks MCP over **stdio**. Stdout is reserved for JSON-RPC; logs
+go to stderr.
+
+## Hook it into Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
+(macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "sv-grid": {
+      "command": "npx",
+      "args": ["-y", "@svgrid/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Open a new chat - the tools above are now available.
+
+## Hook it into Claude Code
+
+```bash
+claude mcp add sv-grid -- npx -y @svgrid/mcp
+```
+
+Then in a session:
+
+> /mcp
+
+…and you'll see `sv-grid` listed. Ask Claude something like *"using sv-grid,
+build me a grid that groups by department and shows a sparkline in each
+row"* and it will pull the relevant example sources before generating code.
+
+## Build from source
+
+```bash
+cd packages/mcp
+pnpm build
+node dist/index.js
+```
+
+`pnpm build` first runs `scripts/build-manifests.mjs`, which reads
+`examples/src/demos/*.svelte` and `docs/**/*.md` from the workspace and
+inlines them into `src/data.ts` so the published npm package is
+self-contained.
+
+## License
+
+MIT. @svgrid/grid is also MIT-licensed; @svgrid/enterprise is a paid companion package under a separate commercial license.