Busca, inspecciona e instala efectos de React, componentes y bloques de páginas listos para copiar y pegar directamente en tu proyecto.
También conocido como Hyperblur/Hyperblur, mcp, @hyperblur/mcp
- Stars
- 0
- Herramientas
- 5
- Descargas, 30 días
- 590
- Última versión
- 0.2.0
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es Hyperblur MCP?
Hyperblur es un MCP server. Busca, inspecciona e instala efectos de React, componentes y bloques de páginas listos para copiar y pegar directamente en tu proyecto. Expone 5 herramientas, como list_categories, search_effects, get_effect.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Hyperblur
Hyperblur ofrece una forma para que los desarrolladores encuentren e integren efectos visuales de React, componentes, microinteracciones y bloques de páginas en sus aplicaciones. Este MCP server conecta clientes de IA como Claude Code, Cursor y Claude Desktop con el catálogo de Hyperblur. Permite que una IA navegue por diferentes categorías, busque palabras clave específicas e inspeccione los detalles técnicos de un elemento, incluyendo sus props y dependencias.
Los usuarios pueden implementar estos elementos visuales directamente en sus entornos de desarrollo locales. El servidor incluye una herramienta para ejecutar el comando de instalación de shadcn para una URL de registro específica, lo cual funciona en proyectos que contienen un package.json y components.json. Para entornos que no utilizan shadcn, el servidor puede obtener el código fuente original del componente. La configuración requiere Node.js 20 o superior y puede configurarse mediante la variable de entorno HYPERBLUR_SITE_URL para apuntar a un catálogo local o remoto.
Qué puedes hacer con él
- 1Descubrir componentes visualesPide a la IA que encuentre efectos de React específicos buscando a través de las categorías del catálogo.
- 2Inspeccionar detalles técnicos de componentesSolicita una referencia completa de un efecto específico para ver sus props requeridos y ejemplos de uso.
- 3Automatizar la instalación de componentesIndica a la IA que instale un componente seleccionado directamente en tu proyecto configurado con shadcn.
- 4Obtención manual de código fuenteObtén el código fuente original de un componente para crear un archivo manualmente cuando no se esté utilizando shadcn.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Hyperblur MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Hyperblur MCP en Claude Code
$ claude mcp add mcp -- npx -y @hyperblur/mcpInstalar Hyperblur MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Instalar Hyperblur MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Instalar Hyperblur MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@hyperblur/mcp"]}'Instalar Hyperblur MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Instalar Hyperblur MCP en Codex
$ codex mcp add mcp -- npx -y @hyperblur/mcpInstalar Hyperblur MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@hyperblur/mcp"]
Instalar Hyperblur MCP en Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @hyperblur/mcpInstalar Hyperblur MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Herramientas de Hyperblur MCP 5
Detectado desde el READMElist_categoriessearch_effectsget_effectget_effect_sourceinstall_effect
| list_categories | — | |
| search_effects | — | |
| get_effect | — | |
| get_effect_source | — | |
| install_effect | — |
Configuración
HYPERBLUR_SITE_URLSite that serves the catalog. Defaults to https://hyperblur.dev.
| Nombre | Descripción | Tipo |
|---|---|---|
| HYPERBLUR_SITE_URL | Site that serves the catalog. Defaults to https://hyperblur.dev. |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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
Preguntas sobre Hyperblur MCP
¿Cómo agrego Hyperblur MCP a Claude Code?
Ejecuta claude mcp add mcp -- npx -y @hyperblur/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Hyperblur MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Hyperblur MCP?
Expone 5 herramientas, incluidas list_categories, search_effects, get_effect, get_effect_source, install_effect.
¿Qué se necesita para instalar un efecto?
Para usar la herramienta install_effect, necesitas un proyecto de React con un package.json configurado para shadcn mediante un archivo components.json.
¿Cómo puedo usar esto con Claude Desktop?
Puedes añadirlo a tu archivo claude_desktop_config.json y luego reiniciar la aplicación.