Search, inspect, and install copy-paste React effects, components, and page blocks directly into your project.
Also known as Hyperblur/Hyperblur, mcp, @hyperblur/mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 days
- 590
- Latest version
- 0.2.0
- Last commit
- Nov 9, 2026
- License
- MIT
What is Hyperblur MCP?
Hyperblur is an MCP server. Search, inspect, and install copy-paste React effects, components, and page blocks directly into your project. It exposes 5 tools, such as list_categories, search_effects, get_effect.
Summary generated from the project's README
About Hyperblur MCP server
Hyperblur provides a way for developers to find and integrate React visual effects, components, micro interactions, and page blocks into their applications. This MCP server connects AI clients like Claude Code, Cursor, and Claude Desktop to the Hyperblur catalog. It allows an AI to browse through different categories, search for specific keywords, and inspect the technical details of an item, including its props and dependencies.
Users can implement these visual elements directly into their local development environments. The server includes a tool to run the shadcn installation command for a specific registry URL, which works in projects containing a package.json and components.json. For environments without shadcn, the server can fetch the raw component source code. Setup requires Node.js 20 or later and can be configured via the HYPERBLUR_SITE_URL environment variable to point to a local or remote catalog.
What you can do with it
- 1Discover visual componentsAsk the AI to find specific React effects by searching through the catalog categories.
- 2Inspect component technical detailsRequest a full reference for a specific effect to see its required props and usage examples.
- 3Automate component installationInstruct the AI to install a selected component directly into your shadcn-configured project.
- 4Manual source code retrievalGet the raw source code of a component to manually create a file when shadcn is not being used.
Written from the project's README. Every use case is checked against a quote from it.
How to install Hyperblur MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Hyperblur MCP in Claude Code
$ claude mcp add mcp -- npx -y @hyperblur/mcpInstall Hyperblur MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Install Hyperblur MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Install Hyperblur MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@hyperblur/mcp"]}'Install Hyperblur MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Install Hyperblur MCP in Codex
$ codex mcp add mcp -- npx -y @hyperblur/mcpInstall Hyperblur MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@hyperblur/mcp"]
Install Hyperblur MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @hyperblur/mcpInstall Hyperblur MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Hyperblur MCP tools 5
Detected from the READMElist_categoriessearch_effectsget_effectget_effect_sourceinstall_effect
| list_categories | — | |
| search_effects | — | |
| get_effect | — | |
| get_effect_source | — | |
| install_effect | — |
Configuration
HYPERBLUR_SITE_URLSite that serves the catalog. Defaults to https://hyperblur.dev.
| Name | Description | |
|---|---|---|
| HYPERBLUR_SITE_URL | Site that serves the catalog. Defaults to https://hyperblur.dev. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on 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 questions
How do I add Hyperblur MCP to Claude Code?
Run claude mcp add mcp -- npx -y @hyperblur/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Hyperblur MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Hyperblur MCP provide?
It exposes 5 tools, including list_categories, search_effects, get_effect, get_effect_source, install_effect.
What is required to install an effect?
To use the install_effect tool, you need a React project with a package.json that is set up for shadcn using a components.json file.
How can I use this with Claude Desktop?
You can add it to your claude_desktop_config.json file and then restart the application.