Skip to main content

Add your description here

Project description

UI MCP Server

CI Coverage

This project initiates at the Power of Europe Hackathon 2025.

Overview

ui-mcp-server is an MCP server that generates specifications for a range of UI components, containing only essential data to remain framework-agnostic. Unlike existing solutions, ui-mcp-server is data-focused, acquiring and filling data during conversation sessions while leaving rendering entirely to frontend developers (for now).

Features

  • Framework-agnostic UI component specifications
  • Data-focused approach with conversation session support
  • Full developer freedom for rendering and customization
  • Compatible with MCP clients like Cursor, Kilo and Claude Desktop

Installation

Claude Desktop

  1. Add the server to your Claude Desktop configuration file (claude_desktop_config.json):

    {
      "mcpServers": {
        "ui-mcp-server": {
          "command": "uvx",
          "args": [
             "ui-mcp-server"
          ]
        },
        // Your existing MCP servers...
      }
    }
    
  2. Restart Claude Desktop to load the MCP server.

Kilo

A working configuration looks like below:

{
  "mcpServers": {
    "ui-mcp-server":{
      "command": "full/path/to/ui-mcp-server",
      "args": []
    }
  }
}

We might have missed something as the expected version below didn't work:

{
  "mcpServers": {
    "ui-mcp-server":{
      "command": "full/path/to/uvx",
      "args": ["ui-mcp-server"]
    }
  }
}

Core concepts

  • UI-as-a-tool: ui-mcp-server provides tools that can be used to generate UI components. To this end, frequently used UI components are defined as tools, and the data required for each tool is acquired during the conversation session. The data extraction part is taken care of by AI agents using this MCP server. See our Streamlit demo for an example (to be updated).
  • Component standardisation: To be agnostic of frontend frameworks, ui-mcp-server defines a standardised component library, which is basically a set of JSON schemas for UI components, with some values are predefined, and others are left to be filled by AI.

Related Projects

  • Magic MCP: Generates React components, focusing on development productivity
  • MCP UI: Similar concept to this project but with tighter coupling to specific UI implementations. Can't be used as a standalone MCP server.
  • shadcn-ui-mcp-server: Similart to MCP UI, a battery-included solution providing shadcn components as source code.

Key Differentiators

Separation of Concerns: ui-mcp-server handles UI types and conversation data exclusively, providing maximum flexibility for developers to customize and render components according to their specific needs and frameworks.

Future work

  • Define standardized component libraries for mainstream frameworks (React, Vue, Svelte, etc.)
  • Create templates to streamline frontend development workflow

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ui_mcp_server-0.0.2.tar.gz (71.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ui_mcp_server-0.0.2-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file ui_mcp_server-0.0.2.tar.gz.

File metadata

  • Download URL: ui_mcp_server-0.0.2.tar.gz
  • Upload date:
  • Size: 71.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ui_mcp_server-0.0.2.tar.gz
Algorithm Hash digest
SHA256 062798ed8136a99a559cb5ed1feb7e31c51a6a39f62abcb07b1a39bcafecb0c9
MD5 071a58de86a6bbe20192ddb76447a610
BLAKE2b-256 e880d796d96607c25f5f9259c9ba68d2a054a52a876b4e66ed9375295911641c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ui_mcp_server-0.0.2.tar.gz:

Publisher: ci.yml on ShaojieJiang/ui-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ui_mcp_server-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: ui_mcp_server-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ui_mcp_server-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1f435ed6e5d96c9233506abae8b4725e4d9426ce2d489b2f62bcabcba15061b6
MD5 7d6af7fef563d1987546fa3d145af5dd
BLAKE2b-256 81e7c561eb8b878a87ac4e4c92dbe40992c290229de5996834375fbd7c935bce

See more details on using hashes here.

Provenance

The following attestation bundles were made for ui_mcp_server-0.0.2-py3-none-any.whl:

Publisher: ci.yml on ShaojieJiang/ui-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page