oyasimi1209 magic mcp

Magic Component Platform (MCP) is a powerful AI-driven tool that helps developers create beautiful, modern UI components instantly through natural language descriptions. It integrates seamlessly with popular IDEs and provides a streamlined workflow for UI development.

• AI-Powered UI Generation: Create UI components by describing them in natural language
• Multi-IDE Support:
  • Cursor IDE integration
  • Windsurf support
  • VSCode + Cline integration (Beta)
• Modern Component Library: Access to a vast collection of pre-built, customizable components inspired by 21st.dev
• Real-time Preview: Instantly see your components as you create them
• TypeScript Support: Full TypeScript support for type-safe development
• SVGL Integration: Access to a vast collection of professional brand assets and logos
• Component Enhancement: Improve existing components with advanced features and animations (Coming Soon)

1. Tell Agent What You Need

   • In your AI Agent's chat, just type /ui and describe the component you're looking for
   • Example: /ui create a modern navigation bar with responsive design

2. Let Magic Create It

   • Your IDE prompts you to use Magic
   • Magic instantly builds a polished UI component
   • Components are inspired by 21st.dev's library

3. Seamless Integration

   • Components are automatically added to your project
   • Start using your new UI components right away
   • All components are fully customizable

• Node.js (Latest LTS version recommended)
• One of the supported IDEs:
  • Cursor
  • Windsurf
  • VSCode (with Cline extension)

1. Generate API Key

   • Visit your Magic dashboard
   • Navigate to the API section
   • Generate a new API key

2. IDE Setup

npx -y @smithery/cli@latest run @21st-dev/magic-mcp --config "{\"TWENTY_FIRST_API_KEY\":\"your-api-key\"}"

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "magic": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "install",
        "@21st-dev/magic-mcp",
        "--client",
        "windsurf"
      ],
      "env": {
        "TWENTY_FIRST_API_KEY": "your-api-key"
      }
    }
  }
}

Add to Cline's MCP configuration:

{
  "mcpServers": {
    "magic": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "install",
        "@21st-dev/magic-mcp",
        "--client",
        "cline"
      ],
      "env": {
        "TWENTY_FIRST_API_KEY": "your-api-key"
      }
    }
  }
}

Magic AI Agent only writes or modifies files related to the components it generates. It follows your project's code style and structure, and integrates seamlessly with your existing codebase without affecting other parts of your application.

Yes! All generated components are fully editable and come with well-structured code. You can modify the styling, functionality, and behavior just like any other React component in your codebase.

If you exceed your monthly generation limit, you'll be prompted to upgrade your plan. You can upgrade at any time to continue generating components. Your existing components will remain fully functional.

Authors can publish components to 21st.dev at any time, and Magic Agent will have immediate access to them. This means you'll always have access to the latest components and design patterns from the community.

Magic AI Agent can handle components of varying complexity, from simple buttons to complex interactive forms. However, for best results, we recommend breaking down very complex UIs into smaller, manageable components.

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

• IdeInstructions: Setup instructions for different IDEs
• ApiKeySection: API key management interface
• WelcomeOnboarding: Onboarding flow for new users

We welcome contributions! Please join our Discord community and provide feedback to help improve Magic Agent. The source code is available on GitHub.

• Discord Community - Join our active community
• Twitter - Follow us for updates

Magic Agent is currently in beta. All features are free during this period. We appreciate your feedback and patience as we continue to improve the platform.

MIT License

• Thanks to our beta testers and community members
• Special thanks to the Cursor, Windsurf, and Cline teams for their collaboration
• Integration with 21st.dev for component inspiration
• SVGL for logo and brand asset integration

For more information, join our Discord community or visit 21st.dev/magic.