bestax-mcp 1.2.1 → 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/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
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
|
}
|