Recherchez, inspectez et installez des effets React, des composants et des blocs de pages prêts à l'emploi directement dans votre projet.
Aussi connu sous Hyperblur/Hyperblur, mcp, @hyperblur/mcp
- Étoiles
- 0
- Outils
- 5
- Téléchargements, 30 jours
- 590
- Dernière version
- 0.2.0
- Dernier commit
- 9 nov. 2026
- Licence
- MIT
Qu'est-ce que Hyperblur MCP ?
Recherchez, inspectez et installez des effets React, des composants et des blocs de pages prêts à l'emploi directement dans votre projet. Il expose 5 outils, comme list_categories, search_effects, get_effect.
Résumé généré à partir du README du projet
À propos du MCP server Hyperblur
Hyperblur offre aux développeurs un moyen de trouver et d'intégrer des effets visuels React, des composants, des micro-interactions et des blocs de pages dans leurs applications. Ce MCP server connecte les clients IA tels que Claude Code, Cursor et Claude Desktop au catalogue Hyperblur. Il permet à une IA de parcourir différentes catégories, de rechercher des mots-clés spécifiques et d'inspecter les détails techniques d'un élément, y compris ses props et ses dépendances.
Les utilisateurs peuvent implémenter ces éléments visuels directement dans leurs environnements de développement locaux. Le serveur inclut un outil pour exécuter la commande d'installation shadcn pour une URL de registre spécifique, ce qui fonctionne dans les projets contenant un package.json et un components.json. Pour les environnements n'utilisant pas shadcn, le serveur peut récupérer le code source brut du composant. La configuration nécessite Node.js 20 ou une version ultérieure et peut être paramétrée via la variable d'environnement HYPERBLUR_SITE_URL pour pointer vers un catalogue local ou distant.
Ce que vous pouvez faire avec
- 1Découvrir des composants visuelsDemandez à l'IA de trouver des effets React spécifiques en effectuant une recherche dans les catégories du catalogue.
- 2Inspecter les détails techniques d'un composantDemandez la référence complète d'un effet spécifique pour voir ses props requises et des exemples d'utilisation.
- 3Automatiser l'installation de composantsDonnez l'instruction à l'IA d'installer un composant sélectionné directement dans votre projet configuré avec shadcn.
- 4Récupération manuelle du code sourceRécupérez le code source brut d'un composant pour créer manuellement un fichier lorsque shadcn n'est pas utilisé.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Hyperblur MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Hyperblur MCP dans Claude Code
$ claude mcp add mcp -- npx -y @hyperblur/mcpInstaller Hyperblur MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Installer Hyperblur MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Installer Hyperblur MCP dans VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@hyperblur/mcp"]}'Installer Hyperblur MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Installer Hyperblur MCP dans Codex
$ codex mcp add mcp -- npx -y @hyperblur/mcpInstaller Hyperblur MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@hyperblur/mcp"]
Installer Hyperblur MCP dans Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @hyperblur/mcpInstaller Hyperblur MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hyperblur/mcp"
]
}
}
}Outils MCP Hyperblur 5
Détectés depuis le 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.
| Nom | Description | Type |
|---|---|---|
| HYPERBLUR_SITE_URL | Site that serves the catalog. Defaults to https://hyperblur.dev. |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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
Questions sur Hyperblur MCP
Comment ajouter Hyperblur MCP à Claude Code ?
Exécutez claude mcp add mcp -- npx -y @hyperblur/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Hyperblur MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Hyperblur MCP fournit-il ?
Il expose 5 outils, dont list_categories, search_effects, get_effect, get_effect_source, install_effect.
Que faut-il pour installer un effet ?
Pour utiliser l'outil install_effect, vous avez besoin d'un projet React avec un fichier package.json configuré pour shadcn via un fichier components.json.
Comment puis-je l'utiliser avec Claude Desktop ?
Vous pouvez l'ajouter à votre fichier claude_desktop_config.json, puis redémarrer l'application.