SupaUI MCP Server

# SupaUI MCP Server A Model Context Protocol (MCP) server for SupaUI that enables AI agents to generate, fetch, and manage UI components through natural language interactions. ## Features - **Create UI Components**: Generate React components based on natural language descriptions - **Fetch UI Components**: Search and retrieve components from buouui.com - **List UI Components**: Browse available components with detailed previews - **TypeScript Support**: Built with TypeScript for better type safety and developer experience ## Prerequisites ### Smithery use [Smithery](https://smithery.ai/server/@buoooou/supaui-mcp) to install supaui-mcp in Claude： ```bash npx -y @smithery/cli install @buoooou/supaui-mcp --client claude ``` ### munal 1. clone repo： ```bash git clone [your-repository-url] cd mcp-ui-gen ``` ======= - Node.js (Latest LTS version) - BUOU_API_KEY from [buouui.com](https://buouui.com/dashboard/key) ## Installation ```bash # Install dependencies pnpm install # Build the project pnpm build ``` ## Configuration 1. Set your BUOU_API_KEY in the environment: ```bash export BUOU_API_KEY=your_api_key_here ``` 2. Or create a configuration file based on smithery.yaml requirements. ## Usage ### Starting the Server ```bash pnpm start ``` ### Available Commands The server supports the following commands: 1. Create UI Component: ``` /ui create a basic button ``` 2. Fetch UI Component: ``` /ui fetch modern login form ``` 3. List UI Components: ``` /buou list cards ``` ## API Tools ### CreateUiTool - Generates new UI components based on natural language descriptions - Endpoint: `/api/create` ### FetchUiTool - Retrieves existing components from buouui.com - Endpoint: `/api/fetch` ### ListUiTool - Lists available components with previews - Endpoint: `/api/list` ## Development ```bash # Build in watch mode tsc -w # Run tests pnpm test ``` ## Environment Variables - `BUOU_API_KEY`: Your API key from buouui.com (Required) ## Contributing 1. Fork the repository 2. Create your feature branch 3. Commit your changes 4. Push to the branch 5. Create a Pull Request ## License ISC ## Support For support, please visit: - [buouui.com](https://buouui.com) - Email: support@buouui.com