local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Integration with Discord for accessing logo assets through the logo_search tool.
Integration with GitHub for accessing logo assets through the logo_search tool.
Requires Node.js as a runtime environment for the Magic AI Agent, supporting the component generation process.

21st.dev Magic AI 에이전트

Magic Component Platform(MCP)은 개발자가 자연어 설명을 통해 아름답고 현대적인 UI 컴포넌트를 즉시 제작할 수 있도록 지원하는 강력한 AI 기반 도구입니다. 널리 사용되는 IDE와 완벽하게 통합되며 UI 개발을 위한 간소화된 워크플로를 제공합니다.

🌟 특징

AI 기반 UI 생성 : 자연어로 설명하여 UI 구성 요소를 생성합니다.
다중 IDE 지원 :
- 커서 IDE 통합
- 윈드서핑 지원
- VSCode 지원
- VSCode + Cline 통합(베타)
최신 구성 요소 라이브러리 : 21st.dev 에서 영감을 받아 미리 구축되고 사용자 정의가 가능한 광범위한 구성 요소 컬렉션에 액세스
실시간 미리보기 : 구성 요소를 만들 때 즉시 구성 요소를 볼 수 있습니다.
TypeScript 지원 : 유형 안전 개발을 위한 전체 TypeScript 지원
SVGL 통합 : 광범위한 전문 브랜드 자산 및 로고 컬렉션에 액세스
구성 요소 향상 : 고급 기능 및 애니메이션으로 기존 구성 요소를 개선합니다(곧 출시)

🎯 작동 원리

에이전트에게 필요한 것을 알려주세요
- AI 에이전트의 채팅에서 /ui 입력하고 찾고 있는 구성 요소를 설명하세요.
- 예: /ui create a modern navigation bar with responsive design
마법이 그것을 창조하게 하세요
- IDE에서 Magic을 사용하라는 메시지가 표시됩니다.
- Magic은 세련된 UI 구성 요소를 즉시 구축합니다.
- 구성 요소는 21st.dev의 라이브러리에서 영감을 받았습니다.
원활한 통합
- 구성 요소는 프로젝트에 자동으로 추가됩니다.
- 새로운 UI 구성요소를 바로 사용해 보세요
- 모든 구성 요소는 완전히 사용자 정의 가능합니다.

🚀 시작하기

필수 조건

Node.js(최신 LTS 버전 권장)
지원되는 IDE 중 하나:
- 커서
- 윈드서핑
- VSCode(Cline 확장 포함)

설치

API 키 생성
- 21st.dev Magic Console을 방문하세요
- 새로운 API 키 생성
설치 방법 선택

방법 1: CLI 설치(권장)

IDE에 MCP를 설치하고 구성하는 명령은 다음과 같습니다.

지엑스피1

지원 클라이언트: 커서, 윈드서핑, 클라인, 클로드

방법 2: 수동 구성

수동 설정을 선호하는 경우 IDE의 MCP 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "@21st-dev/magic": {
      "command": "npx",
      "args": ["-y", "@21st-dev/magic@latest", "API_KEY=\"your-api-key\""]
    }
  }
}

구성 파일 위치:

커서: ~/.cursor/mcp.json
윈드서핑: ~/.codeium/windsurf/mcp_config.json
클라인: ~/.cline/mcp_config.json
클로드: ~/.claude/mcp_config.json

방법 3: VS 코드 설치

한 번의 클릭으로 설치하려면 아래 설치 버튼 중 하나를 클릭하세요.

수동 VS 코드 설정

먼저, 원클릭 설치를 위해 위의 설치 버튼을 확인하세요. 수동 설치의 경우:

VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "21st.dev Magic API Key",
        "password": true
      }
    ],
    "servers": {
      "@21st-dev/magic": {
        "command": "npx",
        "args": ["-y", "@21st-dev/magic@latest"],
        "env": {
          "API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

선택적으로 작업 공간의 .vscode/mcp.json 이라는 파일에 추가할 수 있습니다.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "21st.dev Magic API Key",
      "password": true
    }
  ],
  "servers": {
    "@21st-dev/magic": {
      "command": "npx",
      "args": ["-y", "@21st-dev/magic@latest"],
      "env": {
        "API_KEY": "${input:apiKey}"
      }
    }
  }
}

❓ 자주 묻는 질문

Magic AI Agent는 내 코드베이스를 어떻게 처리하나요?

Magic AI Agent는 생성하는 구성 요소와 관련된 파일만 작성하거나 수정합니다. 프로젝트의 코드 스타일과 구조를 따르며, 애플리케이션의 다른 부분에 영향을 주지 않고 기존 코드베이스와 완벽하게 통합됩니다.

생성된 구성요소를 사용자 정의할 수 있나요?

네! 생성된 모든 컴포넌트는 완벽하게 편집 가능하며 잘 구성된 코드를 포함합니다. 코드베이스의 다른 React 컴포넌트와 마찬가지로 스타일, 기능 및 동작을 수정할 수 있습니다.

세대가 다 떨어지면 어떻게 되나요?

월별 생성 한도를 초과하면 플랜을 업그레이드하라는 메시지가 표시됩니다. 언제든지 업그레이드하여 구성 요소를 계속 생성할 수 있습니다. 기존 구성 요소는 그대로 작동합니다.

21st.dev 라이브러리에 새로운 구성 요소가 추가되는 데 얼마나 걸립니까?

작성자는 언제든지 21st.dev에 컴포넌트를 게시할 수 있으며, Magic Agent는 해당 컴포넌트에 즉시 접근할 수 있습니다. 즉, 커뮤니티의 최신 컴포넌트와 디자인 패턴을 항상 이용할 수 있습니다.

구성 요소의 복잡성에는 한계가 있습니까?

Magic AI Agent는 간단한 버튼부터 복잡한 인터랙티브 양식까지 다양한 복잡성의 구성 요소를 처리할 수 있습니다. 하지만 최상의 결과를 얻으려면 매우 복잡한 UI를 작고 관리하기 쉬운 구성 요소로 나누는 것이 좋습니다.

🛠️ 개발

프로젝트 구조

mcp/
├── app/
│   └── components/     # Core UI components
├── types/             # TypeScript type definitions
├── lib/              # Utility functions
└── public/           # Static assets

주요 구성 요소

IdeInstructions : 다양한 IDE에 대한 설정 지침
ApiKeySection : API 키 관리 인터페이스
WelcomeOnboarding : 신규 사용자를 위한 온보딩 흐름

🤝 기여하기

여러분의 참여를 환영합니다! Discord 커뮤니티 에 가입하시고 Magic Agent 개선에 도움이 되는 피드백을 남겨주세요. 소스 코드는 GitHub 에서 확인하실 수 있습니다.

👥 커뮤니티 및 지원

Discord 커뮤니티 - 활발한 커뮤니티에 참여하세요
Twitter - 최신 소식을 받아보려면 팔로우하세요

⚠️ 베타 공지

Magic Agent는 현재 베타 버전입니다. 이 기간 동안 모든 기능은 무료로 이용하실 수 있습니다. 플랫폼을 지속적으로 개선해 나가는 동안 여러분의 소중한 의견과 양해 부탁드립니다.

📝 라이센스

MIT 라이센스

🙏 감사의 말

베타 테스터와 커뮤니티 멤버들에게 감사드립니다.
Cursor, Windsurf 및 Cline 팀의 협력에 특별히 감사드립니다.
21st.dev 와의 통합을 통해 구성 요소에 대한 영감을 얻다
로고 및 브랜드 자산 통합을 위한 SVGL

자세한 내용을 알아보려면 Discord 커뮤니티 에 가입하거나 21st.dev/magic을 방문하세요.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

자연어 설명에서 최신 UI 구성 요소를 생성하는 AI 기반 도구로, 인기 있는 IDE와 통합되어 UI 개발 워크플로를 간소화합니다.

Related Resources

Reddit Discussion about this server

Magic Component Platform (MCP)