Bestax

Name: Bestax
Author: allxsmith

本地服务

bestax.io开发工具13今天更新

代码仓库访问官网

关于 Bestax

bestax-mcp 是 `@allxsmith/bestax-bulma` 的官方 MCP 服务，为编码 Agent 提供 React 组件文档、示例和样式变量。索引离线随包发布，并检查文档版本与项目安装版本是否一致。

主要功能

01列出和搜索组件
02查询属性及组合子组件
03提供可运行的 TSX 示例
04查询 Bulma CSS 变量
05提供 Agent Skills 与提示词

适用场景

01查找适合需求的组件及属性
02为组件实现参考示例
03检查组件关联的 CSS 变量

MCP 相关

向 MCP 客户端提供组件、属性、示例、CSS 变量和 Agent Skills 的工具、提示词及资源，并检查项目中安装的 `@allxsmith/bestax-bulma` 版本。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "allxsmith-bestax": {
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ],
      "env": {
        "BESTAX_MCP_NO_VERSION_CHECK": "<BESTAX_MCP_NO_VERSION_CHECK>",
        "BESTAX_MCP_PROJECT_DIR": "<BESTAX_MCP_PROJECT_DIR>"
      }
    }
  }
}

启动命令npx -y bestax-mcp

需要配置的环境变量

BESTAX_MCP_NO_VERSION_CHECKSkip comparing your installed @allxsmith/bestax-bulma version with the one the index documents

BESTAX_MCP_PROJECT_DIRYour project directory, where the installed @allxsmith/bestax-bulma version is read from; defaults to the directory the server starts in

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmbestax-mcp1.18.14stdio

工具

收录的工具列表 · 更新于今天

参数	类型	必填	说明
kind	enum	否	将结果限制为一种类型。默认返回全部类型。component \| prop \| example \| css-var \| skill \| all
limit	integer	否
query	string	是	要查找的内容，例如 "date picker" 或 "spacing"

详细介绍

bestax-mcp

官方的 MCP 服务，适用于 @allxsmith/bestax-bulma —— 用于 Bulma v1 的 React 组件。

它为编码 Agent 提供整个组件库：每个组件的属性（包括 Navbar.Brand 等复合子部分）、约 900 个可运行示例、每个组件背后的 --bulma-* CSS 变量、可替代内联样式的辅助属性，以及可调用为提示词的 bestax Agent Skills。

离线且版本固定。 索引随软件包一同发布——无需网络调用，也不会受到速率限制。它记录的是特定版本的 bestax-bulma，服务会检查项目中实际安装的版本，并在两者不一致时发出警告，而不会自信地描述你并未安装的属性。

设置

每个版本都会以 io.github.allxsmith/bestax-mcp 的名称发布到官方 MCP Registry，供从该 Registry 安装的客户端使用。

Claude Code

claude mcp add bestax -- npx -y bestax-mcp@1

或者安装 bestax 插件。它会运行同一 MCP 服务，并添加 bestax Agent Skills：

/plugin marketplace add allxsmith/bestax-skills
/plugin install bestax@bestax

Cursor、Claude Desktop、Windsurf、Cline

将以下内容添加到 MCP 配置中（.cursor/mcp.json、claude_desktop_config.json 等）：

{
  "mcpServers": {
    "bestax": {
      "command": "npx",
      "args": ["-y", "bestax-mcp@1"]
    }
  }
}

服务会根据其文档中记录的版本检查已安装的 @allxsmith/bestax-bulma，并从启动目录开始查找。如果客户端在项目目录以外的位置启动服务，请在配置的 env 中通过 BESTAX_MCP_PROJECT_DIR 指定项目目录：

{
  "mcpServers": {
    "bestax": {
      "command": "npx",
      "args": ["-y", "bestax-mcp@1"],
      "env": { "BESTAX_MCP_PROJECT_DIR": "/path/to/your/project" }
    }
  }
}

如果没有找到已安装的副本，它的第一个回答会说明这一点。

@1 会固定主版本。若不指定，npx 每次启动都会解析到最新版本——因此，下次启动 Agent 时，破坏性变更或遭到入侵的版本就会到达 Agent，无需经过审核。你也可以将它添加到开发依赖中，让锁文件来决定版本。

工具

从 list_components 开始——其输出会告诉你接下来要调用哪个工具。如果不知道组件名称，请使用 search_bestax。

工具	提供的内容
`list_components`	按类别列出所有组件及其一句话用途
`search_bestax`	在一个排序列表中列出组件、属性、示例、CSS 变量和技能
`get_component`	导入信息、摘要和属性；可选获取示例、CSS 变量、无障碍信息及相关内容
`get_props`	单个属性表，包括复合子路径（`Navbar.Brand`）
`get_examples`	组件文档页面中的可运行 `tsx` 示例
`get_css_variables`	组件读取的 `--bulma-*` 自定义属性，以及 Sass 名称和默认值
`get_helper_props`	间距、颜色、排版、弹性布局和可见性属性——编写内联样式前请先调用此工具
`lookup_bulma_classes`	对应 Bulma 类字符串（`button is-primary`）的 bestax 组件和属性；每个类占一行
`list_skills`	七个 bestax Agent Skills
`get_skill`	某项技能的说明，或其参考文档

提示词

每项技能各有一个提示词，让任务可以从库自身的指导开始： custom-component、form、theming、layout-scaffold、icons、migrate、 optimize。

资源

bestax://catalog · bestax://components/{name} · bestax://skills/{name} · bestax://skills/{name}/references/{ref}

环境

变量	作用
`BESTAX_MCP_NO_VERSION_CHECK`	设为 `1` 可完全跳过已安装版本检查
`BESTAX_MCP_PROJECT_DIR`	项目路径；适用于在项目目录之外启动服务的客户端；默认值为工作目录