Skip to main content

Add your description here

Project description

UI MCP Server

CI Coverage PyPI

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": "full/path/to/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.3.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.3-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ui_mcp_server-0.0.3.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.3.tar.gz
Algorithm Hash digest
SHA256 a61073ae65777e338633fce733f30d90c0ff790a2ed7696e189d57c417d03c62
MD5 652972772345ebf8da6fcb1f64c62454
BLAKE2b-256 849350c5e9608a70a7b7ae830ea5a84e4c043be764cff2214f408b1c6d82b684

See more details on using hashes here.

Provenance

The following attestation bundles were made for ui_mcp_server-0.0.3.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.3-py3-none-any.whl.

File metadata

  • Download URL: ui_mcp_server-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 5.4 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9144f2117b3a59b84c5cc8eaaf414f747f79980d08fc15ab1bd21210c14e7417
MD5 972cfa59222c9992595568141acd3999
BLAKE2b-256 8d285ecd24417548afb8aad139b5dc40f9966b6be261b00105f3fd4edbb9a9a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for ui_mcp_server-0.0.3-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