bestax-mcp 1.2.0 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -0
- package/data/catalog.json +1 -1
- package/data/components/Columns.json +1 -1
- package/data/components/Grid.json +1 -1
- package/data/skills/bestax-custom-component/references/component-catalog.md +2 -2
- package/data/skills/bestax-migrate/references/unmappables.md +1 -1
- package/data/skills.json +2 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# bestax-mcp
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/bestax-mcp)
|
|
4
|
+
[](https://www.npmjs.com/package/bestax-mcp)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://socket.dev/npm/package/bestax-mcp/overview)
|
|
7
|
+
[](https://scorecard.dev/viewer/?uri=github.com/allxsmith/bestax)
|
|
8
|
+
[](https://www.bestpractices.dev/projects/14361)
|
|
9
|
+
[](https://www.npmjs.com/package/bestax-mcp#provenance)
|
|
10
|
+
[](https://github.com/allxsmith/bestax/blob/main/SECURITY.md)
|
|
11
|
+
|
|
3
12
|
The official [MCP](https://modelcontextprotocol.io) server for
|
|
4
13
|
[`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) —
|
|
5
14
|
React components for Bulma v1.
|
package/data/catalog.json
CHANGED
|
@@ -123,12 +123,12 @@ component is guaranteed to appear (the generator fails if one lacks an API page)
|
|
|
123
123
|
## Columns
|
|
124
124
|
|
|
125
125
|
- [Column](https://bestax.io/docs/api/columns/column) — The `Column` component provides a single responsive layout column using Bulma's flexbox-based column system.
|
|
126
|
-
- [Columns](https://bestax.io/docs/api/columns
|
|
126
|
+
- [Columns](https://bestax.io/docs/api/columns) — The `Columns` component provides Bulma's flexible, responsive grid container for aligning and distributing [`Column`](./column.md) components.
|
|
127
127
|
|
|
128
128
|
## Grid
|
|
129
129
|
|
|
130
130
|
- [Cell](https://bestax.io/docs/api/grid/cell) — The `Cell` component provides a single Bulma grid cell for use inside the [`Grid`](./grid.md) component.
|
|
131
|
-
- [Grid](https://bestax.io/docs/api/grid
|
|
131
|
+
- [Grid](https://bestax.io/docs/api/grid) — The `Grid` component provides Bulma's advanced CSS Grid layout for complex, modern layouts.
|
|
132
132
|
|
|
133
133
|
## Layout
|
|
134
134
|
|
|
@@ -32,7 +32,7 @@ matches the usage, or plain JSX with classes:
|
|
|
32
32
|
## `Tile` — Bulma v1 replaced tiles with Grid
|
|
33
33
|
|
|
34
34
|
Convert ancestor/parent/child tile trees to `Grid`/`Cell` (docs:
|
|
35
|
-
https://bestax.io/docs/api/grid
|
|
35
|
+
https://bestax.io/docs/api/grid):
|
|
36
36
|
|
|
37
37
|
```tsx
|
|
38
38
|
// Before
|
package/data/skills.json
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
{
|
|
11
11
|
"id": "component-catalog",
|
|
12
12
|
"file": "references/component-catalog.md",
|
|
13
|
-
"bytes":
|
|
13
|
+
"bytes": 17429
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"id": "library-contributor",
|
|
@@ -99,7 +99,7 @@
|
|
|
99
99
|
{
|
|
100
100
|
"id": "unmappables",
|
|
101
101
|
"file": "references/unmappables.md",
|
|
102
|
-
"bytes":
|
|
102
|
+
"bytes": 4861
|
|
103
103
|
}
|
|
104
104
|
],
|
|
105
105
|
"examples": []
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bestax-mcp",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.2",
|
|
4
4
|
"description": "MCP server for @allxsmith/bestax-bulma — component props, examples, CSS variables and agent skills, served offline from a version-pinned index",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -66,5 +66,5 @@
|
|
|
66
66
|
"clean": "rimraf dist",
|
|
67
67
|
"release": "npx semantic-release"
|
|
68
68
|
},
|
|
69
|
-
"readme": "# bestax-mcp\n\nThe official [MCP](https://modelcontextprotocol.io) server for\n[`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) —\nReact components for Bulma v1.\n\nIt gives a coding agent the whole library: every component's props (including\ncompound sub-parts like `Navbar.Brand`), ~900 working examples, the `--bulma-*`\nCSS variables behind every component, the helper props that replace inline\nstyles, and the bestax [Agent Skills](https://bestax.io/docs/skills/intro) as\ninvocable prompts.\n\n**Offline and version-pinned.** The index ships inside the package — no network\ncalls, nothing to rate-limit. It documents one specific `bestax-bulma` release,\nand the server checks the version actually installed in your project and warns\nyou when they disagree, rather than confidently describing props you do not have.\n\n## Setup\n\n### Claude Code\n\n```bash\nclaude mcp add bestax -- npx -y bestax-mcp@1\n```\n\n### Cursor, Claude Desktop, Windsurf, Cline\n\nAdd to your MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, …):\n\n```json\n{\n \"mcpServers\": {\n \"bestax\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"bestax-mcp@1\"]\n }\n }\n}\n```\n\nRun it from your project directory so it can find your installed\n`@allxsmith/bestax-bulma` and check it against the indexed version.\n\nThe `@1` pins the major version. Without it, `npx` resolves whatever is newest on every\nlaunch — so a breaking change, or a compromised release, reaches your agent the next time it\nstarts, with no review step. Add it to your dev dependencies instead if you would rather your\nlockfile decide.\n\n## Tools\n\nStart with `list_components` — its output names the tool to call next. Reach for\n`search_bestax` when you need a component whose name you do not know.\n\n| Tool | What it gives you |\n| ------------------- | -------------------------------------------------------------------------------------------------------- |\n| `list_components` | All 87 components with a one-line purpose, by category |\n| `search_bestax` | Components, props, examples, CSS variables and skills in one ranked list |\n| `get_component` | Import, summary and props; optionally examples, CSS variables, accessibility, related |\n| `get_props` | One prop table, including compound sub-paths (`Navbar.Brand`) |\n| `get_examples` | Working `tsx` examples from the component's docs page |\n| `get_css_variables` | The `--bulma-*` custom properties a component reads, with Sass names and defaults |\n| `get_helper_props` | Spacing, colour, typography, flexbox and visibility props — **call this before writing an inline style** |\n| `list_skills` | The seven bestax Agent Skills |\n| `get_skill` | A skill's instructions, or one of its reference documents |\n\n## Prompts\n\nOne per skill, so a task can start from the library's own guidance:\n`custom-component`, `form`, `theming`, `layout-scaffold`, `icons`, `migrate`,\n`optimize`.\n\n## Resources\n\n`bestax://catalog` · `bestax://components/{name}` · `bestax://skills/{name}` ·\n`bestax://skills/{name}/references/{ref}`\n\n## Environment\n\n| Variable | Effect |\n| ----------------------------- | ------------------------------------------------------- |\n| `BESTAX_MCP_NO_VERSION_CHECK` | Set to `1` to skip the installed-version check entirely |\n\n## Links\n\n- [LLMs guide](https://bestax.io/docs/guides/llms) — the canonical entry point for\n bestax's AI surfaces, including `llms.txt` and the Agent Skills\n- [Documentation](https://bestax.io)\n- [GitHub](https://github.com/allxsmith/bestax)\n\nMIT © Alex Smith\n"
|
|
69
|
+
"readme": "# bestax-mcp\n\n[](https://www.npmjs.com/package/bestax-mcp)\n[](https://www.npmjs.com/package/bestax-mcp)\n[](https://opensource.org/licenses/MIT)\n[](https://socket.dev/npm/package/bestax-mcp/overview)\n[](https://scorecard.dev/viewer/?uri=github.com/allxsmith/bestax)\n[](https://www.bestpractices.dev/projects/14361)\n[](https://www.npmjs.com/package/bestax-mcp#provenance)\n[](https://github.com/allxsmith/bestax/blob/main/SECURITY.md)\n\nThe official [MCP](https://modelcontextprotocol.io) server for\n[`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) —\nReact components for Bulma v1.\n\nIt gives a coding agent the whole library: every component's props (including\ncompound sub-parts like `Navbar.Brand`), ~900 working examples, the `--bulma-*`\nCSS variables behind every component, the helper props that replace inline\nstyles, and the bestax [Agent Skills](https://bestax.io/docs/skills/intro) as\ninvocable prompts.\n\n**Offline and version-pinned.** The index ships inside the package — no network\ncalls, nothing to rate-limit. It documents one specific `bestax-bulma` release,\nand the server checks the version actually installed in your project and warns\nyou when they disagree, rather than confidently describing props you do not have.\n\n## Setup\n\n### Claude Code\n\n```bash\nclaude mcp add bestax -- npx -y bestax-mcp@1\n```\n\n### Cursor, Claude Desktop, Windsurf, Cline\n\nAdd to your MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, …):\n\n```json\n{\n \"mcpServers\": {\n \"bestax\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"bestax-mcp@1\"]\n }\n }\n}\n```\n\nRun it from your project directory so it can find your installed\n`@allxsmith/bestax-bulma` and check it against the indexed version.\n\nThe `@1` pins the major version. Without it, `npx` resolves whatever is newest on every\nlaunch — so a breaking change, or a compromised release, reaches your agent the next time it\nstarts, with no review step. Add it to your dev dependencies instead if you would rather your\nlockfile decide.\n\n## Tools\n\nStart with `list_components` — its output names the tool to call next. Reach for\n`search_bestax` when you need a component whose name you do not know.\n\n| Tool | What it gives you |\n| ------------------- | -------------------------------------------------------------------------------------------------------- |\n| `list_components` | All 87 components with a one-line purpose, by category |\n| `search_bestax` | Components, props, examples, CSS variables and skills in one ranked list |\n| `get_component` | Import, summary and props; optionally examples, CSS variables, accessibility, related |\n| `get_props` | One prop table, including compound sub-paths (`Navbar.Brand`) |\n| `get_examples` | Working `tsx` examples from the component's docs page |\n| `get_css_variables` | The `--bulma-*` custom properties a component reads, with Sass names and defaults |\n| `get_helper_props` | Spacing, colour, typography, flexbox and visibility props — **call this before writing an inline style** |\n| `list_skills` | The seven bestax Agent Skills |\n| `get_skill` | A skill's instructions, or one of its reference documents |\n\n## Prompts\n\nOne per skill, so a task can start from the library's own guidance:\n`custom-component`, `form`, `theming`, `layout-scaffold`, `icons`, `migrate`,\n`optimize`.\n\n## Resources\n\n`bestax://catalog` · `bestax://components/{name}` · `bestax://skills/{name}` ·\n`bestax://skills/{name}/references/{ref}`\n\n## Environment\n\n| Variable | Effect |\n| ----------------------------- | ------------------------------------------------------- |\n| `BESTAX_MCP_NO_VERSION_CHECK` | Set to `1` to skip the installed-version check entirely |\n\n## Links\n\n- [LLMs guide](https://bestax.io/docs/guides/llms) — the canonical entry point for\n bestax's AI surfaces, including `llms.txt` and the Agent Skills\n- [Documentation](https://bestax.io)\n- [GitHub](https://github.com/allxsmith/bestax)\n\nMIT © Alex Smith\n"
|
|
70
70
|
}
|