NEURIA Design Intelligence MCP

Inteligencia de diseño impulsada por emociones para herramientas de codificación de IA. Obtén tokens de diseño, ADN de marca y parámetros de animación a través de MCP.

Documentación

MCP Compatible 10 Tools 6 Emotions MIT License

NEURIA — Inteligencia de Diseño Impulsada por Emociones para Herramientas de Codificación con IA

NEURIA es un servidor MCP (Model Context Protocol) que brinda a asistentes de IA como Claude, Cursor y Windsurf un sentido del gusto en diseño. En lugar de depender de los valores predeterminados genéricos de Tailwind o paletas de colores codificadas, los agentes de IA consultan a NEURIA para obtener tokens de diseño alineados con las emociones — colores, tipografía, espaciado, animaciones — todo respaldado por datos reales de más de 300 sitios web galardonados.

"El diseño no es solo cómo se ve. El diseño es cómo se siente." — Steve Jobs

NEURIA cuantifica ese sentimiento en tokens de diseño accionables.


¿Qué es NEURIA?

NEURIA mapea 6 emociones principales a sistemas de diseño completos:

EmociónVibraMarcas de ejemplo
ConfianzaEstable, confiable, profesionalLinear, Stripe, Notion
EmociónAudaz, enérgico, dinámicoVercel, Arc, Framer
CalmaSereno, minimalista, respirableHeadspace, Muji, Apple
LujoPremium, refinado, exclusivoPorsche, Rolex, Aesop
InnovaciónFuturista, vanguardista, inteligenteOpenAI, Tesla, Figma
EnergíaVibrante, juguetón, de alto ritmoSpotify, Discord, Duolingo

Cada emoción incluye paletas de colores, configuraciones de tipografía, escalas de espaciado, radios de borde, estilos de sombra y parámetros de animación — todo derivado del análisis estadístico de CSS real extraído de más de 300 sitios web destacados.


Inicio Rápido

1. Añade a tu configuración de MCP

Añade a tu .mcp.json (Claude Code) o configuración MCP del IDE:

{
  "mcpServers": {
    "neuria": {
      "type": "sse",
      "url": "https://api.neuria.tech/mcp"
    }
  }
}

Eso es todo. No se necesita clave API para las herramientas principales.

2. Desarrollo Local (Opcional)

git clone https://github.com/kosukeuemura0220-del/neuria-agent.git
cd neuria-agent
pip install -r requirements.txt
cp .env.example .env
# Fill in API keys for advanced tools (see .env.example)
python3 mcp-servers/neuria/server.py

10 Herramientas MCP

Herramientas Principales (Sin Clave API Requerida)

#HerramientaDescripciónEntrada
1get_emotion_tokensObtener propiedades personalizadas de CSS para una emociónemotion, category
2search_similar_designsEncontrar diseños similares mediante similitud coseno de pgvectorquery, mood, component_type
3get_color_paletteObtener una paleta de 5 colores + esquema de API de Coloremotion, industry
4get_typographyObtener configuraciones de fuente para emoción × caso de usoemotion, use_case
5score_htmlPuntuar HTML según los estándares de diseño de NEURIAhtml_content, target_emotion, url
8get_animation_tokensObtener parámetros de animación GSAP / CSS / Springemotion, context

Herramientas Avanzadas (Se Requieren Claves API)

#HerramientaDescripciónClaves Requeridas
6generate_hero_imageImagen hero generada por IA y alineada con la emoción3D AI Studio
7analyze_reference_urlExtraer tokens de diseño de cualquier URL (formato W3C DTCG)FIRECRAWL_API_KEY
9analyze_visual_designAnálisis dual: colores de captura de pantalla + análisis CSSSCREENSHOTONE_API_KEY, IMAGGA_API_KEY
10analyze_brand_voiceAnálisis de emociones en texto mediante Hume AIHUME_API_KEY

Ejemplo de Uso

1. Generar una Página de Aterrizaje con Tokens de Emoción

User: "Analyze linear.app and create a SaaS landing page with the same design feel"

→ NEURIA calls: analyze_reference_url("https://linear.app")
  Returns: dominant_emotion="innovation", W3C DTCG design tokens, emotion_scores

→ NEURIA calls: get_emotion_tokens("innovation")
  Returns: CSS variables (--neuria-bg, --neuria-accent, --neuria-font-*, etc.)

→ NEURIA calls: get_animation_tokens("innovation", "page_load")
  Returns: GSAP ease, CSS cubic-bezier, Spring physics params

→ Claude generates HTML using NEURIA tokens (no hardcoded colors)
→ NEURIA calls: score_html(generated_html, "innovation")
  Returns: composite_score=87/100 ✅

2. Paleta de Colores Rápida para Fintech

User: "I need a trustworthy color palette for a fintech app"

→ get_color_palette("trust", industry="fintech")
  Returns:
  {
    "background": "#0B1120",
    "surface": "#131D36",
    "accent": "#2E7DFF",
    "text_primary": "#E8ECF4",
    "text_secondary": "#7A8BAB",
    "color_scheme": [...5 harmonious colors from The Color API]
  }

3. Análisis de Voz de Marca

User: "What emotion does Apple's copy convey?"

→ analyze_brand_voice(url="https://apple.com")
  Returns:
  {
    "dominant_emotion": "innovation",
    "neuria_emotions": {
      "innovation": 0.31,
      "luxury": 0.24,
      "calm": 0.19,
      ...
    }
  }

Arquitectura

┌──────────────────────────────────────────────┐
│              AI Coding Tool                   │
│     (Claude Code / Cursor / Windsurf)         │
└──────────────┬───────────────────────────────┘
               │ MCP Protocol (stdio / SSE)
               ▼
┌──────────────────────────────────────────────┐
│            NEURIA MCP Server                  │
│                                               │
│  ┌─────────┐ ┌──────────┐ ┌──────────────┐  │
│  │ Emotion  │ │ Supabase │ │  External    │  │
│  │ Token DB │ │ pgvector │ │  APIs        │  │
│  │ (6×CSS)  │ │ (300+    │ │              │  │
│  │          │ │  sites)  │ │ • Firecrawl  │  │
│  └─────────┘ └──────────┘ │ • Color API  │  │
│                            │ • ScreenShot │  │
│  ┌─────────────────────┐  │ • Imagga     │  │
│  │ Animation Tokens    │  │ • Hume AI    │  │
│  │ (6 emotions ×       │  │ • WAVE       │  │
│  │  4 contexts)        │  │ • 3D AI      │  │
│  └─────────────────────┘  └──────────────┘  │
└──────────────────────────────────────────────┘

Sistema de Puntuación

score_html evalúa el HTML generado en 4 dimensiones:

DimensiónPesoQué mide
Estética35%Armonía visual, espacio en blanco, uso del color
Emoción35%Alineación con los tokens de emoción objetivo
Técnica15%Marcado limpio, rendimiento, responsive
Accesibilidad15%WCAG 2.1 AA (lang, alt, contraste, encabezados)

Objetivo: 85+ / 100 para una salida de calidad de producción.


Variables de Entorno

Crea un archivo .env en la raíz del proyecto (consulta .env.example):

# Required for core functionality
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_anon_key
NEURIA_API_BASE=your_api_base_url

# Required for analyze_reference_url
FIRECRAWL_API_KEY=your_firecrawl_key

# Required for generate_hero_image
THREE_D_AI_STUDIO_KEY=your_3d_ai_key

# Required for analyze_visual_design
SCREENSHOTONE_API_KEY=your_key
IMAGGA_API_KEY=your_key
IMAGGA_API_SECRET=your_secret

# Required for analyze_brand_voice
HUME_API_KEY=your_hume_key

# Optional — WAVE accessibility API
WAVE_API_KEY=your_wave_key

Precios

Próximamente

PlanPrecioSolicitudes
Free$0/mes5 solicitudes/día
Indie$19/mes500 solicitudes/mes
Pro$49/mes2,000 solicitudes/mes
Team$149/mes10,000 solicitudes/mes
EnterprisePersonalizadoIlimitado

Enlaces


Licencia

Licencia MIT — consulta LICENSE para más detalles.


NEURIA — Porque la UI generada por IA no debería parecer UI generada por IA.