mcp-ui-expo-tamagui
Generates React Native/Expo UI components using AI, including search of Expo documentation.
Uses Google Gemini AI to generate, optimize, and theme UI components based on natural language descriptions.
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., "@mcp-ui-expo-tamagui Create a login form component with email and password fields."
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.
๐จ MCP UI Expo Tamagui Server
AI-Powered UI Component Generator for Expo + Tamagui with Claude Desktop Integration
๐ Automatically generate React Native/Expo components using AI Gemini through Model Context Protocol (MCP)
โจ Features
๐ค AI Component Generation: Create components with natural language descriptions
๐ Real-time Docs Search: Search Expo & Tamagui documentation
โก Code Optimization: Optimize components for performance
๐จ Theme Configuration: Generate theme configs automatically
๐ก Smart Suggestions: Intelligent component recommendations
๐ณ Docker Ready: Production-ready containerization
๐ง TypeScript Support: Full type safety
Related MCP server: React Native MCP Server
๐ Quick Start
1. Installation & Build
git clone https://github.com/yourusername/mcp-ui-expo-tamagui.git
cd mcp-ui-expo-tamagui
npm install
npm run build2. Configure API Key
export GEMINI_API_KEY=your-gemini-api-key3. Test MCP Server
./test-mcp-tools.sh๐ Claude Desktop Integration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mcp-ui-expo-tamagui": {
"command": "node",
"args": ["/path/to/mcp-ui-expo-tamagui/build/index.js"],
"env": {
"GEMINI_API_KEY": "your-gemini-api-key"
}
}
}
}Usage with Claude
๐ฌ "Create a Button component with title, onPress, and variant props"
๐ฌ "How to implement navigation in Expo?"
๐ฌ "Suggest components for an e-commerce screen"
๐ฌ "Optimize this component for performance"
๐ฌ "Create dark theme with purple primary color"๐ ๏ธ MCP Tools
Tool | Description | Parameters |
| Generate UI component with AI | name, description, props, styling, platform |
| Search Expo documentation | query |
| Search Tamagui documentation | query |
| Get component suggestions | context, requirements |
| Optimize component code | code, optimizationType |
| Create theme configuration | colorScheme, primaryColors, components |
๐ณ Docker Deployment
Build & Run
# Build Docker image
docker build -t mcp-ui-expo-tamagui .
# Run with Docker Compose
docker-compose up
# Run standalone
docker run -e GEMINI_API_KEY=your-key mcp-ui-expo-tamagui๐งช Testing
# Test MCP tools
./test-mcp-tools.sh
# Test Docker
./test-docker.sh
# TypeScript validation
npm run lint
# Jest tests
npm test๐ Project Structure
mcp-ui-expo-tamagui/
โโโ src/
โ โโโ index.ts # Main MCP server
โ โโโ types/interfaces.ts # Type definitions
โ โโโ services/ # Core services
โ โโโ utils/ # Utilities
โโโ build/ # Compiled output
โโโ Dockerfile # Docker configuration
โโโ docker-compose.yml # Docker Compose
โโโ README.md # Documentation๐ฏ Example Use Cases
E-commerce Product Card
{
name: "ProductCard",
description: "Product card with image, title, price, rating, add to cart",
props: [
{ name: "product", type: "Product", required: true },
{ name: "onAddToCart", type: "function", required: true }
]
}Social Media Post
{
name: "PostCard",
description: "Post card with avatar, content, reactions",
styling: { theme: "dark", responsive: true }
}๐ง Development
npm run dev # Development mode
npm run build # Build production
npm run test # Run tests
npm run lint # TypeScript check๐จ Environment Variables
GEMINI_API_KEY- Google Gemini AI API key (required)NODE_ENV- Environment (optional)LOG_LEVEL- Logging level (optional)
๐ License
MIT License - see LICENSE file for details.
๐ Ready to Go!
Start creating amazing UI components with AI! ๐โจ
Happy Coding!
Available Tools
6 toolscreate_theme_configB
Generate Tamagui theme configuration
Inputs: colorScheme (required), components, designSystem, primaryColor.
generate_ui_componentC
Generate UI component using Expo + Tamagui with AI assistance
Inputs: description (required), componentType (required), style, features, +1 more.
get_component_suggestionsB
Get AI-powered component suggestions based on requirements
Inputs: requirement (required), context, preferences.
optimize_componentC
Optimize existing component code with AI suggestions
Inputs: code (required), targetPlatform, optimizationGoals.
search_expo_docsC
Search Expo documentation for specific topics
Inputs: query (required), category.
search_tamagui_docsB
Search Tamagui documentation for components and styling
Inputs: query (required), category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 6 tools
Most tools are distinct actions (search vs optimize vs theme creation), but generate_ui_component and get_component_suggestions both target new component creation, creating potential confusion about which to use for a given task. The descriptions hint at a difference (final code vs recommendations) but are brief enough to cause misselection.
All tool names follow a consistent verb_noun pattern in snake_case (generate, search, get, optimize, create). The two search tools are parallel (search_expo_docs, search_tamagui_docs), and every name clearly starts with an action verb. No mixed conventions or irregularities.
With six tools, the set is well-scoped for the server's purpose of UI development with Expo and Tamagui. Each tool addresses a specific need (generation, documentation, suggestions, optimization, theming) without redundant or excess additions. The count feels complete and not bloated.
The tool surface covers the primary lifecycle of UI component development: design/generate, get suggestions, optimize, search docs, and configure themes. Minor gaps exist, such as no explicit tool for previewing components or managing component dependencies, but these are not critical for the core workflow and can be worked around with existing tools.
Maintenance
Related MCP Connectors
Your Expo and EAS project in natural language: up to date SDK docs, cloud builds (status, logs, trig
React + Tailwind UI components and recipes your AI coding tool can search and install.
React + Tailwind UI components and recipes your AI coding tool can search and install.
Visual builder for React Native and Expo apps. Read and update project design tokens.
Related MCP Servers
- AlicenseBqualityDmaintenancereact-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user prompts98 npm76MIT
- AlicenseAqualityDmaintenanceProvides comprehensive tools for React Native development, automating project initialization, version management, upgrades, Expo integration, and development workflows through AI assistance.217 npm21MIT
- AlicenseCqualityDmaintenanceAn extensible Model Context Protocol server that enables AI assistants like Claude to generate React Native components and perform development tasks through a standardized interface.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to view and analyze screenshots from React Native/Expo applications for AI-powered mobile UI development. Integrates with Claude, Cursor, VS Code and other MCP-compatible editors.11 npm15MIT