Bestax について
bestax-mcpは、`@allxsmith/bestax-bulma`公式のMCPサーバーで、コーディングエージェントにReactコンポーネントのドキュメント、例、スタイル変数を提供します。索引はオフラインでパッケージに含まれ、記載対象とプロジェクトのインストール済みバージョンを照合します。
主な機能
- 01コンポーネントの一覧表示と検索
- 02propsと複合サブコンポーネントの参照
- 03動作するTSX例の提供
- 04Bulma CSS変数の参照
- 05Agent Skillsとプロンプトの提供
活用シーン
- 01要件に合うコンポーネントとpropsの検索
- 02コンポーネント実装時の例の参照
- 03コンポーネントが使うCSS変数の確認
MCP 対応
コンポーネント、props、例、CSS変数、Agent Skillsに関するツール、プロンプト、リソースをMCPクライアントに提供します。プロジェクトにインストールされた`@allxsmith/bestax-bulma`のバージョンも確認します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y bestax-mcpBESTAX_MCP_NO_VERSION_CHECKSkip comparing your installed @allxsmith/bestax-bulma version with the one the index documentsBESTAX_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
10掲載時のツール一覧 · 今日に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| kind | enum | いいえ | 結果を 1 種類に絞ります。デフォルトではすべてが対象です。component | prop | example | css-var | skill | all |
| limit | integer | いいえ | |
| query | string | はい | 検索する内容。例:"date picker" または "spacing" |
詳細
bestax-mcp
@allxsmith/bestax-bulma 向けの公式 MCP サーバーです。
Bulma v1 用の React コンポーネントを提供します。
コーディングエージェントがライブラリ全体を利用できるようになります。各コンポーネントの props(Navbar.Brand のような複合サブパーツを含む)、約 900 個の実用的な例、各コンポーネントを支える --bulma-* CSS 変数、インラインスタイルに代わるヘルパー props、さらに呼び出し可能なプロンプトとしての bestax Agent Skills を提供します。
オフラインで動作し、バージョンが固定されています。 インデックスはパッケージ内に同梱されるため、ネットワーク呼び出しはなく、レート制限を受けることもありません。特定の bestax-bulma リリースを記載しており、サーバーはプロジェクトに実際にインストールされているバージョンを確認します。バージョンが一致しない場合は、存在しない props を自信たっぷりに説明するのではなく、警告します。
セットアップ
各リリースは、そこからインストールするクライアント向けに、公式の
MCP Registry へ
io.github.allxsmith/bestax-mcp として公開されています。
Claude Code
claude mcp add bestax -- npx -y bestax-mcp@1
代わりに bestax プラグインをインストールすることもできます。同じサーバーを実行し、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 は起動のたびに最新バージョンを解決します。そのため、破壊的変更や侵害されたリリースが、確認の手順を挟まず、次回の起動時にエージェントへ届いてしまいます。代わりにロックファイルでバージョンを管理したい場合は、開発用依存関係に追加してください。
ツール
まず list_components を実行してください。出力に、次に呼び出すツールが記載されています。名前がわからないコンポーネントが必要な場合は、search_bestax を使用してください。
| ツール | 得られる情報 |
|---|---|
list_components | カテゴリ別の全コンポーネントと、それぞれの簡単な用途 |
search_bestax | コンポーネント、プロパティ、例、CSS 変数、スキルを関連度順にまとめた一覧 |
get_component | インポート方法、概要、プロパティ。必要に応じて例、CSS 変数、アクセシビリティ、関連情報も取得できます |
get_props | 複合コンポーネントのサブパス(Navbar.Brand)を含む、1 つのプロパティ表 |
get_examples | コンポーネントのドキュメントページにある動作する tsx の例 |
get_css_variables | コンポーネントが参照する --bulma-* カスタムプロパティと、Sass 名およびデフォルト値 |
get_helper_props | 余白、色、タイポグラフィ、フレックスボックス、表示に関するプロパティ — インラインスタイルを書く前に呼び出してください |
lookup_bulma_classes | Bulma のクラス文字列(button is-primary)に対応する最適な bestax コンポーネントとプロパティ。クラスごとに 1 行 |
list_skills | 7 つの bestax Agent Skills |
get_skill | スキルの手順、またはそのリファレンスドキュメントのいずれか |
プロンプト
タスクをライブラリ独自のガイダンスから始められるよう、各スキルに 1 つずつ用意されています。
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 | サーバーをプロジェクト外で起動するクライアント向けの、プロジェクトのパス。デフォルトは作業ディレクトリです |
リンク
ソースコードは MIT ライセンスです
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。