Skip to main content
Glama

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 claude

munal

  1. clone repo:

git clone [your-repository-url]
cd mcp-ui-gen
  • Node.js (Latest LTS version)

  • BUOU_API_KEY from buouui.com

Installation

# Install dependencies
pnpm install

# Build the project
pnpm build

Configuration

  1. Set your BUOU_API_KEY in the environment:

export BUOU_API_KEY=your_api_key_here
  1. Or create a configuration file based on smithery.yaml requirements.

Usage

Starting the Server

pnpm start

Available Commands

The server supports the following commands:

  1. Fetch UI Component:

/ui fetch modern login form
  1. List UI Components:

/buou list cards
  1. Create Image:

/image a minimal logo for a coffee shop

API Tools

FetchUiTool (fetch-ui)

  • Input: searchQuery

  • Returns the best matching component: its files, the npm packages to install, the @/components/ui components it imports, and other close matches

  • Endpoint: /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, image

  • Returns the URL of the generated image

  • Endpoint: /api/image

Development

# Build in watch mode
pnpm exec tsc -w

Environment Variables

  • BUOU_API_KEY: Your API key from buouui.com (Required)

  • BUOU_API_URL: Base URL of the API, defaults to https://buouui.com. Point it to http://localhost:3000 to develop against a local site

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:

Available Tools

3 tools
create-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

    C2.6/5.0

    Scored across 3 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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.
      78
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      A 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.
      2
      14
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A 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.
      90
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      60
      MIT