Skip to main content
Glama
lukeylias

Mesh Design System MCP Server

by lukeylias

MeshMCP - Mesh Design System MCP Server

A stdio-based Model Context Protocol (MCP) server that provides Claude Code (VS Code) access to the Mesh Design System components, design tokens, and prototyping tools.

Features

  • 🎨 Component Discovery - List all Mesh Design System components

  • πŸ“‹ Component Details - Get props, examples, and design guidance

  • 🎨 Design Tokens - Access colors, typography, and spacing tokens

  • πŸ”„ Placeholder Data - Generate realistic insurance/healthcare test data

  • πŸ” Use Case Search - Find components for specific UI patterns

  • πŸ’» Code Generation - Generate React prototype code with Mesh components

  • ⚑ Smart Caching - File-based caching with TTL for performance

Related MCP server: SupaUI MCP Server

Quick Start

1. Install Dependencies

⚠️ Dependencies Fixed! See INSTALL.md for detailed installation instructions.

pip install -r requirements.txt playwright install chromium

2. Test the Server

python3 test_mcp.py

3. Configure in VS Code

Add to ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{ "mcpServers": { "mesh-design-system": { "command": "python3", "args": ["main.py"], "cwd": "/Users/luke.ylias/Documents/GitHub/MeshMCP" } } }

Restart VS Code and start using the tools with Claude!

Available Tools

Tool

Description

Example

list_components

Lists all Mesh components

"List all Mesh components"

get_component_details

Get component props & examples

"Get details for Button component"

get_design_tokens

Retrieve design tokens

"Show me Mesh color tokens"

generate_placeholder_data

Generate test data

"Generate 5 member records"

search_components_by_use_case

Find components for use cases

"Components for a data table"

generate_prototype_code

Generate React code

"Create a member signup form"

Project Structure

MeshMCP/ β”œβ”€β”€ main.py # FastMCP server entry point β”œβ”€β”€ requirements.txt # Python dependencies β”œβ”€β”€ test_mcp.py # Test script β”œβ”€β”€ SETUP.md # Detailed setup guide β”œβ”€β”€ QUICK_START.md # Quick reference β”œβ”€β”€ scrapers/ β”‚ └── mesh_scraper.py # Web scraping with Playwright β”œβ”€β”€ cache/ β”‚ └── cache_manager.py # File-based caching β”œβ”€β”€ generators/ β”‚ └── data_generator.py # Placeholder data generation └── models/ └── mcp_models.py # Pydantic models

How It Works

Claude Code (VS Code) ↓ stdio (JSON-RPC) FastMCP Server (main.py) ↓ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ mesh_scraper.py (Playwright)β”‚ β†’ Mesh Design System β”‚ cache_manager.py (File) β”‚ β†’ cache_data/ β”‚ data_generator.py (Faker) β”‚ β†’ Test data β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Troubleshooting

Server not connecting?

# Verify installation python3 test_mcp.py # Check MCP package pip list | grep mcp

Cache issues?

# Clear cache (will regenerate) rm -rf cache_data/

Playwright errors?

# Reinstall browsers playwright install --force chromium

Documentation

Tech Stack

  • MCP SDK - Model Context Protocol for Claude integration

  • Playwright - Web scraping for component data

  • Faker - Realistic Australian insurance data generation

  • Pydantic - Data validation

  • aiofiles - Async file operations for caching

License

See LICENSE file for details.

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lukeylias/MeshMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server