UI HUB MCP Server

Servidor independiente del Model Context Protocol (MCP) para la plataforma de componentes de UI accesible mediante IA UI HUB.

Este servidor permite a los asistentes de codificación con IA (Cursor, Claude Code, VS Code/Copilot y otros clientes MCP) buscar, descubrir y recuperar componentes de UI HUB, código fuente, dependencias, plantillas y animaciones.

Inicio rápido (local)

npm install
# copy .env.example to .env and fill in Firebase credentials
npm run build
npm start

O en desarrollo:

npm run dev

Related MCP server: Cortex

Endpoints

Variables de entorno

Consulta .env.example. Variables clave:

• MCP_SERVER_URL — URL base pública de este servicio (p. ej. https://ui-hub-mcp.onrender.com)

• MCP_API_KEY_PREFIX — por defecto uh_live_

• MCP_RATE_LIMIT_FREE / MCP_RATE_LIMIT_PRO — límites diarios de solicitudes por plan

• FIREBASE_PROJECT_ID / FIREBASE_CLIENT_EMAIL / FIREBASE_PRIVATE_KEY — credenciales del SDK de Firebase Admin

• REDIS_URL — (opcional) Upstash Redis para limitación de velocidad distribuida

• MCP_ADMIN_EMAILS — anulaciones de correos electrónicos de administrador separadas por comas

• MCP_ALLOWED_ORIGINS — orígenes CORS separados por comas

Puerto: por defecto se usa PORT (Render lo establece automáticamente), con respaldo en MCP_PORT y, después, en 3001.

Desplegar en Render

Este repositorio está diseñado para desplegarse de manera independiente en Render como un servicio web Node.js de larga duración.

1. En Render, crea un New Web Service y conecta este repositorio.

2. Render detecta automáticamente el runtime de Node.

3. Establece el Build Command: npm install && npm run build

4. Establece el Start Command: node dist/index.js

5. Establece el Health Check Path: /health

6. Añade las variables de entorno indicadas anteriormente.

7. Opcionalmente, adjunta el blueprint incluido render.yaml.

O utiliza el Blueprint de Render (Infrastructure as Code) con el render.yaml incluido:

render blueprint create --file render.yaml

Herramientas MCP

• search_components

• get_component

• get_component_code

• search_templates

• get_template

• search_animations

• get_animation_code

• list_categories

• get_dependencies

Documentación completa: consulta docs/mcp.md en el repositorio principal de UI HUB o la estructura de docs dentro del repositorio.

Autenticación

Las claves de API usan el formato uh_live_xxxxxxxxxxxxxxxxxxxxxxxxx y se envían como:

Authorization: Bearer uh_live_xxxxxxxxxxxxxxxxxxxxxxxxx

Las claves se almacenan como hashes SHA-256 en la colección de Firestore mcp_api_keys.

Pruebas

npm test

40 pruebas que cubren autenticación, permisos, gestión de claves de API, limitación de velocidad y todas las herramientas MCP.