open-index/open-npm huggingface dataset:
npm package: @htmlbricks/mcp
Description: MCP server with HTML Bricks (hb-*) web component catalog resources and tools for agentic IDEs.
Latest version: 0.71.18

# @htmlbricks/mcp

Model Context Protocol server for **HTML Bricks** (`hb-*` web components). It exposes the agent catalog reference, `list.json`, CDN helpers, search, and prompts so coding agents can build correct markup (snake_case attributes, Bootstrap 5, Bootstrap Icons).

## Usage (agentic IDEs)

Run via stdio (example for MCP clients):

```json
{
  "command": "npx",
  "args": ["-y", "@htmlbricks/mcp"]
}
```

Requires **Node.js 18+**. The published package embeds `AGENT_WEBCOMPONENTS_REFERENCE.md` and `list.json` for the same version as `@htmlbricks/hb-bundle`. If assets are missing, the server falls back to jsDelivr for that version.

## Resources

| URI | Content |
|-----|---------|
| `htmlbricks://docs/development-guide` | Conventions and workflow |
| `htmlbricks://catalog/agent-reference` | Full merged component reference (Markdown) |
| `htmlbricks://catalog/package-list` | `list.json`: per package, `definitions.events` (event names → schema for `detail`) and `definitions.component` (prop types as JSON Schema) |

## Tools

- **search_catalog** — keyword search in the reference
- **get_component_schemas** — `definitions.events` + `definitions.component` for one `hb-*` (from bundled `list.json`)
- **get_bundle_cdn_urls** — jsDelivr URLs for `hb-bundle` matching this package version

## Prompts

- **plan_htmlbricks_page** — structured task to read resources and plan UI with `hb-*` elements