Reactのエフェクト、コンポーネント、ページブロックを検索、確認し、プロジェクトへ直接コピー&ペーストしてインストールできます。
別名 Hyperblur/Hyperblur, mcp, @hyperblur/mcp
- スター
- 0
- ツール
- 5
- ダウンロード数(30日間)
- 590
- 最新バージョン
- 0.2.0
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
Hyperblur MCPとは
HyperblurはMCPサーバーです。 Reactのエフェクト、コンポーネント、ページブロックを検索、確認し、プロジェクトへ直接コピー&ペーストしてインストールできます。. 5個のツールを提供しており、list_categories, search_effects, get_effectなどがあります。
プロジェクトのREADMEから生成された概要
Hyperblur MCP server について
Hyperblurは、開発者がReactのビジュアルエフェクト、コンポーネント、マイクロインタラクション、ページブロックをアプリケーションに見つけ出し、統合するための手段を提供します。このMCP serverは、Claude Code、Cursor、Claude DesktopなどのAIクライアントをHyperblurのカタログに接続します。これにより、AIがさまざまなカテゴリを閲覧したり、特定のキーワードで検索したり、propsや依存関係を含むアイテムの技術的な詳細を確認したりすることが可能になります。
ユーザーは、これらのビジュアル要素をローカルの開発環境に直接実装できます。このサーバーには、特定のレジストリURLに対してshadcnのインストールコマンドを実行するツールが含まれており、package.jsonとcomponents.jsonを含むプロジェクトで動作します。shadcnを使用していない環境では、サーバーがコンポーネントの生のソースコードを取得することも可能です。セットアップにはNode.js 20以降が必要で、HYPERBLUR_SITE_URL環境変数を使用して、ローカルまたはリモートのカタログを指すように設定できます。
できること
- 1ビジュアルコンポーネントの発見カタログのカテゴリを検索して、特定のReactエフェクトをAIに見つけさせます。
- 2コンポーネントの技術詳細の確認特定のエフェクトのリファレンスを要求し、必要なpropsや使用例を確認します。
- 3コンポーネントインストールの自動化選択したコンポーネントを、shadcnが設定されているプロジェクトに直接インストールするようAIに指示します。
- 4ソースコードの手動取得shadcnを使用していない場合に、コンポーネントの生のソースコードを取得して手動でファイルを作成します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Hyperblur MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにHyperblur MCPをインストール
$ claude mcp add mcp -- npx -y @hyperblur/mcpCursorにHyperblur MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}VS CodeにHyperblur MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}VS Code CLIにHyperblur MCPをインストール
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@hyperblur/mcp"]}'Claude DesktopにHyperblur MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}CodexにHyperblur MCPをインストール
$ codex mcp add mcp -- npx -y @hyperblur/mcpCodex config.tomlにHyperblur MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@hyperblur/mcp"]
Gemini CLIにHyperblur MCPをインストール
$ gemini mcp add -s user mcp npx -- -y @hyperblur/mcpGemini settings.jsonにHyperblur MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Hyperblur MCPツール 5
READMEから検出list_categoriessearch_effectsget_effectget_effect_sourceinstall_effect
| list_categories | — | |
| search_effects | — | |
| get_effect | — | |
| get_effect_source | — | |
| install_effect | — |
設定
HYPERBLUR_SITE_URLSite that serves the catalog. Defaults to https://hyperblur.dev.
| 名前 | 説明 | 種類 |
|---|---|---|
| HYPERBLUR_SITE_URL | Site that serves the catalog. Defaults to https://hyperblur.dev. |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見る@hyperblur/mcp
An MCP server for Hyperblur, the catalog of copy-paste React visual effects. The catalog covers effects, components, micro interactions and page blocks. It lets MCP clients such as Claude Code, Cursor and Claude Desktop browse the catalog by category, search it, read an item's props and usage, fetch its source, and install it into a project through the shadcn registry.
Requirements
- Node.js 20 or later
- For
install_effect: a React project with apackage.json, set up for shadcn (components.json)
Setup
Claude Code
claude mcp add hyperblur -- npx -y @hyperblur/mcp
Cursor
Add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects:
{
"mcpServers": {
"hyperblur": {
"command": "npx",
"args": ["-y", "@hyperblur/mcp"]
}
}
}
Claude Desktop
Add to claude_desktop_config.json (Settings > Developer > Edit Config), then restart the app:
{
"mcpServers": {
"hyperblur": {
"command": "npx",
"args": ["-y", "@hyperblur/mcp"]
}
}
}
Configuration
| Variable | Default | Description |
|---|---|---|
HYPERBLUR_SITE_URL |
https://hyperblur.dev |
Site that serves the catalog (/r/index.json) and registry items (/r/<slug>.json). Point it at http://localhost:3000 when working on the site locally. |
Pass it through the env field of your client config, or with claude mcp add hyperblur -e HYPERBLUR_SITE_URL=http://localhost:3000 -- npx -y @hyperblur/mcp.
The catalog index is cached in memory for five minutes.
Tools
| Tool | Purpose |
|---|---|
list_categories |
Every category in the catalog with its item count and three example titles. |
search_effects |
Search by keyword and optional category. The category can be any category present in the catalog (see list_categories); an unknown one returns an error that lists the available categories. Returns slug, title, category, description and install command for each match. |
get_effect |
Full reference for one item: props table, usage example, import line, dependencies, install command and docs link. |
get_effect_source |
The component source and its target path, for writing the file by hand when shadcn is not available. |
install_effect |
Runs npx shadcn@latest add <registry-url> --yes in the given project directory (--overwrite optional) and reports the output and installed file. |
It also exposes the resource hyperblur://catalog (the full catalog index as JSON) and the prompt add_effect, which walks through looking up and installing an effect, component or block by slug.
Development
npm install
npm run build
npm test
HYPERBLUR_SITE_URL=http://localhost:3000 npm start
License
MIT
Hyperblur MCPのよくある質問
Hyperblur MCPをClaude Codeに追加するには
ターミナルでclaude mcp add mcp -- npx -y @hyperblur/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Hyperblur MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Hyperblur MCPが提供するツールは
5個のツールを提供しており、list_categories, search_effects, get_effect, get_effect_source, install_effectなどがあります。
エフェクトをインストールするには何が必要ですか?
install_effectツールを使用するには、components.jsonファイルを使用してshadcnの設定が完了している、package.jsonを含むReactプロジェクトが必要です。
Claude Desktopでどのように使用できますか?
claude_desktop_config.jsonファイルに追加した後、アプリケーションを再起動してください。