React 효과, 컴포넌트, 페이지 블록을 검색, 검토하고 프로젝트에 직접 복사하여 설치합니다.
다른 이름 Hyperblur/Hyperblur, mcp, @hyperblur/mcp
- 스타
- 0
- Tools
- 5
- 다운로드, 30일
- 590
- 최신 버전
- 0.2.0
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
Hyperblur MCP란?
Hyperblur은(는) MCP server입니다. 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 및 의존성을 포함한 항목의 기술적 세부 정보를 검토할 수 있도록 지원합니다.
사용자는 이러한 시각적 요소를 로컬 개발 환경에 직접 구현할 수 있습니다. 이 서버에는 특정 registry URL에 대한 shadcn 설치 명령을 실행하는 도구가 포함되어 있으며, 이는 package.json과 components.json이 있는 프로젝트에서 작동합니다. shadcn을 사용하지 않는 환경의 경우, 서버가 컴포넌트의 원본 소스 코드를 가져올 수 있습니다. 설정에는 Node.js 20 이상이 필요하며, HYPERBLUR_SITE_URL 환경 변수를 통해 로컬 또는 원격 카탈로그를 가리키도록 구성할 수 있습니다.
활용 사례
- 1시각적 컴포넌트 탐색카탈로그 카테고리를 검색하여 AI에게 특정 React 효과를 찾아달라고 요청합니다.
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
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 파일에 추가한 후 애플리케이션을 재시작하면 됩니다.