SupaUI MCP Server
A Model Context Protocol server for SupaUI that lets AI agents browse/fetch UI components from buouui.com and generate or edit images.
Fetch UI components (
fetch-ui): search buouui.com and return the best matching component’s source files, required npm packages, imported@/components/uicomponents, and close matches.List UI components (
list-ui): browse available component names, optionally filtered by a search keyword.Create/edit images (
create-image): generate or edit an image from natural language and return its URL.Integrate results: after fetching components, the agent can edit/add files to integrate snippets into the codebase; after image generation, it can show/download the image.
Runs on Node.js, allowing deployment of the UI generation capabilities as a service accessible via API endpoints.
Uses pnpm for package management, providing an efficient way to install and manage dependencies for the UI component server.
Enables the generation of React components based on natural language descriptions, supporting the creation of UI elements for React applications.
Built with TypeScript for better type safety, providing well-typed component generation and API interactions for UI development.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SupaUI MCP Server create a responsive navigation bar with dark mode toggle"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SupaUI MCP Server
A Model Context Protocol (MCP) server for SupaUI that enables AI agents to fetch and browse UI components from buouui.com and to generate images through natural language interactions.
Features
Fetch UI Components: Search buouui.com and get a component's source code together with the npm packages and other components it needs
List UI Components: Browse the available components, optionally filtered by keyword
Create Images: Generate or edit an image and get its URL
TypeScript Support: Built with TypeScript for better type safety and developer experience
Related MCP server: MCP Magic UI
Prerequisites
Smithery
use Smithery to install supaui-mcp in Claude:
npx -y @smithery/cli install @buoooou/supaui-mcp --client claudemunal
clone repo:
git clone [your-repository-url]
cd mcp-ui-genNode.js (Latest LTS version)
BUOU_API_KEY from buouui.com
Installation
# Install dependencies
pnpm install
# Build the project
pnpm buildConfiguration
Set your BUOU_API_KEY in the environment:
export BUOU_API_KEY=your_api_key_hereOr create a configuration file based on smithery.yaml requirements.
Usage
Starting the Server
pnpm startAvailable Commands
The server supports the following commands:
Fetch UI Component:
/ui fetch modern login formList UI Components:
/buou list cardsCreate Image:
/image a minimal logo for a coffee shopAPI Tools
FetchUiTool (fetch-ui)
Input:
searchQueryReturns the best matching component: its files, the npm packages to install, the
@/components/uicomponents it imports, and other close matchesEndpoint:
/api/fetch
ListUiTool (list-ui)
Input:
searchQuery(optional)Lists component names, filtered by the keyword when one is given
Endpoint:
/api/list
CreateImageTool (create-image)
Input:
message,imageReturns the URL of the generated image
Endpoint:
/api/image
Development
# Build in watch mode
pnpm exec tsc -wEnvironment Variables
BUOU_API_KEY: Your API key from buouui.com (Required)BUOU_API_URL: Base URL of the API, defaults tohttps://buouui.com. Point it tohttp://localhost:3000to develop against a local site
Contributing
Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a Pull Request
License
ISC
Support
For support, please visit:
Email: support@buouui.com
Available Tools
3 toolscreate-imageC
"Use this tool when the user requests a new image, mentions /buou /image or asks for a image. If the customer provides the picture editing operation of the attachment, please send it to the corresponding tool. This tool ONLY returns the url of the image. After calling this tool, Please show the image returned by this tool and provide it for download.
Inputs: message (required), image (required).
fetch-uiB
"Use this tool when the user wants to see component, get inspiration, or /buou or /ui fetch data and previews from buouui.com. This tool ONLY returns the text snippet for that UI component. After calling this tool, you must edit or add files to integrate the snippet into the codebase."
Inputs: message (required), searchQuery (required).
list-uiC
"Use this tool when the user wants to see buouui.com component, or /buou fetch data and previews from buouui.com. This tool returns the JSON data of matching components without generating new code. This tool ONLY returns the text snippet for that UI component. After calling this tool, you need to display the data in the UI, and finally you need to show the website page of the buouui.com."
Inputs: message (required), searchQuery (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The tools have unclear boundaries and overlapping purposes. 'fetch-ui' and 'list-ui' both handle UI components from buouui.com with similar triggers ('/buou'), making them easily confused. 'create-image' is more distinct but still shares the '/buou' trigger, adding to the ambiguity. The descriptions don't clearly differentiate when to use one over the other.
The naming follows a mixed convention: 'create-image' uses a verb_noun pattern with hyphenation, while 'fetch-ui' and 'list-ui' use verb_noun with underscores. This inconsistency in delimiter usage (hyphens vs. underscores) reduces predictability, though the verb_noun structure is mostly maintained across tools.
With only 3 tools, the count feels thin for a server named 'SupaUI MCP Server', which suggests a broader UI-related scope. While it covers image creation and UI component fetching/listing, the limited number might not support comprehensive UI workflows, such as editing or managing components beyond basic retrieval.
The tool set is significantly incomplete for a UI-focused server. It lacks essential operations like updating or deleting UI components, managing image edits, or handling user interactions beyond fetching. The overlap between 'fetch-ui' and 'list-ui' further complicates coverage, leaving obvious gaps in CRUD/lifecycle management for the domain.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
MCP server for building and testing AI agents with multi-model experimentation and insights.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA server that provides rich UI context and interaction capabilities to AI models, enabling deep understanding of user interfaces through visual analysis and precise interaction via Model Context Protocol.78MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides access to Magic UI components, allowing AI assistants and other MCP clients to discover and use UI components from the Magic UI design system.214MIT

CodeAlive MCPofficial
AlicenseNot gradedqualityBmaintenanceA Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.90MIT- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.60MIT