Starwind UI MCP Server

Starwind UI v3 및 Starwind Pro를 위한 TypeScript Model Context Protocol 서버입니다. AI 클라이언트에게 Astro 및 React 프로젝트에 대한 최신 프레임워크 인식 가이드를 제공합니다.

빠른 시작

유지 관리되는 클라이언트 설정 가이드는 Starwind UI MCP 문서를 참조하세요.

Codex (~/.codex/config.toml):

[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
enabled = true

Claude Code (.mcp.json) 또는 Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"]
    }
  }
}

설정을 변경한 후 클라이언트를 다시 시작하거나 MCP 서버를 다시 로드하세요.

Related MCP server: shadcn-ui MCP Server

v3 모델

Starwind UI v3에는 세 가지 관련 표면이 있습니다. MCP는 이를 구분하여 유지합니다:

서버는 이러한 계층을 버전이 지정된 ai-manifest.json에 대해 검증하고, 검증된 데이터를 캐시하며, 사이트를 사용할 수 없는 경우 번들로 제공된 v3 스냅샷으로 대체합니다.

도구

도구 호출은 읽기 가능한 JSON 텍스트와 MCP structuredContent를 모두 반환합니다.

요구 사항 및 동작

• 생성된 v3 CLI 명령어는 Node.js 22.12.0 이상이 필요합니다.

• starwind_init는 기존 Astro 5+ 또는 React 18+ 프로젝트를 대상으로 하며, framework가 제공되지 않는 한 CLI가 프레임워크를 자동 감지하도록 합니다.

• 무료 @starwind-pro/* 카탈로그 블록은 일반 초기화 후에 작동합니다. 유료 블록은 명시적인 승인이 필요합니다. 필요한 경우에만 pro: true를 전달하세요.

• Starwind Pro 블록은 현재 Astro를 대상으로 합니다. React 검색은 이를 생략하고, React 추가 요청은 명시적으로 거부합니다.

• 마이그레이션은 기본적으로 대화형입니다. 백업 및 덮어쓰기 동작이 의도된 경우에만 yes: true를 설정하세요.

• 패키지 관리자 및 프로젝트 컨텍스트는 가능한 경우 로컬에서 감지되며, add 명령어는 확인된 패키지 관리자를 CLI에 전달합니다. 어떤 도구도 생성된 명령어를 실행하지 않습니다.

무료에서 Pro로 업그레이드

MCP는 유료 설정을 강제하지 않고 Pro를 검색 가능하게 유지합니다. 검색 결과는 Pro 카탈로그에 연결되며, 무료 Pro 블록은 직접 설치 가능하고, 유료 결과에는 구매 및 설치 링크가 포함된 구조화된 proUpgrade 경로가 포함됩니다.

기존 Astro 프로젝트의 경우 MCP는 다음을 권장합니다:

pnpm dlx starwind@latest setup --yes

설정 명령어는 프로젝트의 패키지 관리자를 자동 감지하므로 --package-manager 플래그가 필요하지 않습니다. Pro 레지스트리와 .env.local을 준비합니다. STARWIND_LICENSE_KEY 자리 표시자를 구매한 키로 바꾼 다음 반환된 deferredCommand를 실행하세요. 키를 민감한 정보로 취급하세요. .env.local을 소스 제어에서 제외하고 로그나 클라이언트 측 코드에 키를 절대 노출하지 마세요. pro: true로 초기화된 프로젝트는 대신 동등한 init --pro 명령어를 받습니다.

개발

pnpm build
pnpm lint
pnpm test:run

옵트인 프로덕션 매니페스트 계약 테스트를 실행하려면:

RUN_LIVE_CONTRACT_TESTS=1 pnpm test:run src/utils/starwind_live_contract.test.ts

라이선스

MIT. LICENSE를 참조하세요.

보안