npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@gridcraft/mcp

v1.0.0

Published

MCP server — AI authoring aid for GridCraft grids.

Readme

@gridcraft/mcp

An MCP server that helps AI assistants build grids with @gridcraft/angular. Run one prompt, answer a short interview, and get back ready-to-paste Angular code that compiles. The assistant can also read the GridCraft docs pages, their code samples, and the theme engine while it works.

It is a separate package from @gridcraft/angular and never touches the grid's runtime code. A copy of the docs ships inside the package, so the server works offline and describes the version it was released with.

Connecting a client

Claude Code

claude mcp add gridcraft -- npx @gridcraft/mcp

VS Code / Copilot — .vscode/mcp.json

{
  "servers": {
    "gridcraft": { "command": "npx", "args": ["@gridcraft/mcp"] }
  }
}

Cursor — .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

{
  "mcpServers": {
    "gridcraft": { "command": "npx", "args": ["@gridcraft/mcp"] }
  }
}

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "gridcraft": { "command": "npx", "args": ["@gridcraft/mcp"] }
  }
}

Node 18 or later.

Prompts (4)

An MCP server can't draw its own UI, so these prompts instruct the host AI to ask the questions in its own question UI, then call the tools below.

| Prompt | What it does | Argument | |---|---|---| | create-grid | Full interview — entity & columns, data source, features, layout, theme — then validate_config and scaffold_grid, and presents the .ts + .html. | description — free-text grid idea; pre-fills every answer it can infer. | | quick-start | Fast path: shows the install lines, asks only the essentials (columns, data source, must-have features), then generates immediately. | context — optional hint, e.g. "a products table with sorting". | | theme-grid | Interviews for brand colours, then derives a full WCAG-checked GridThemeTokens set ready to bind to [themeTokens]. | brand — accent / mode hint, e.g. "violet, dark mode". | | upgrade-grid | Version-by-version migration plan from the package's changelog — breaking changes first, then an ordered checklist. | from / to — version range (detected if omitted). |

How each client invokes a prompt:

| Client | Syntax | |---|---| | Claude Code | /mcp__gridcraft__create-grid an invoices table with a status filter | | Cursor | /gridcraft:create-grid an invoices table with a status filter | | VS Code / Copilot | mcp.gridcraft.create-grid an invoices table with a status filter |

Tools (14)

| Tool | Purpose | |---|---| | scaffold_grid | Generate a component .ts + .html (+ optional theme SCSS) from a structured spec, importing from @gridcraft/angular. Runs validate_config first and lists any warning in its notes. | | validate_config | Check a spec for options that don't work together — for example managed row drag under a client-side sort. Returns { valid, findings[] }; each finding has a level, a code, a message and a fix. | | search_docs | Keyword search across the docs pages. Condensed by default; format: "full" for complete excerpts. | | get_doc | One docs page as markdown, by its path (features/sorting, or just sorting). | | list_features | Every docs page, grouped by section, with a one-line summary. | | list_examples / get_example | The code samples of a docs page, exactly as the page shows them. | | list_themes | The default and dark themes with their complete token sets. | | get_theme_tokens | The themeable-token registry — every --gc-* variable, its group, type and bounds. | | derive_theme | Expand seed colours into a full token set, with a contrast report. | | detect_version | The @gridcraft/angular and Angular versions: an active override, then your package.json, then the version these docs describe (source: "snapshot"). | | set_version | Pin the version detect_version reports (saved to ~/.gridcraft-mcp/config.json) — the starting point of upgrade-grid. | | list_versions | Every release in the package's changelog, newest first. | | list_changes | The changelog entries between two versions. |

scaffold_grid covers the options documented for the grid: columns (sortable, filterable, editable, pinned), a filter row or popup filters, row selection, row expansion, row drag, CSV export, cell flash on applyTransaction(), keyboard navigation, infinite or paged scrolling, and the built-in themes (default, material, dark, hero, hero-dark) or seed colours.

Resources

  • gridcraft://docs/<page> — one per docs page, e.g. gridcraft://docs/features/sorting
  • gridcraft://themes/registry, gridcraft://themes/base/default, gridcraft://themes/base/dark
  • gridcraft://api/public — the names @gridcraft/angular exports for the features documented here
  • gridcraft://changelog — the package's public changelog
  • gridcraft://version — { activeVersion, libraryVersion, detected }

Versions and the changelog

The changelog starts at 1.0.0, the first public release, so upgrade-grid has nothing to migrate yet and says so. Each later release adds an entry under ### Added, Changed, Deprecated, Removed, Fixed, Security or Breaking (Keep a Changelog).

Verifying a connection

npx @modelcontextprotocol/inspector npx @gridcraft/mcp

stdout is the JSON-RPC channel; the server logs only to stderr.

Developing (in the GridCraft repo)

| Command | What it does | |---|---| | npm run mcp | Start the server from source on stdio. | | npm run mcp:knowledge | Rebuild knowledge/ (docs + code samples) from the docs site — run it after changing a docs page. changelog.md there is written by hand. | | npm run test:mcp | Unit tests (changelog parser, version detection). | | node mcp-server/scripts/check-packaged.mjs | Pack, install outside the repo, and check every tool, prompt and resource — and that only the public docs are served. | | node mcp-server/scripts/check-scaffold.mjs | Generate grids with scaffold_grid and compile them with strictTemplates. |

npm pack builds dist/ first (prepack).