NEURIA Design Intelligence MCP

Inteligência de design orientada por emoção para ferramentas de codificação de IA. Obtenha tokens de design, DNA da marca e parâmetros de animação via MCP.

GitHub

Documentação

NEURIA — Inteligência de Design Orientada por Emoção para Ferramentas de Codificação com IA

NEURIA é um servidor MCP (Model Context Protocol) que dá a assistentes de IA como Claude, Cursor e Windsurf um senso de bom gosto em design. Em vez de depender de padrões genéricos do Tailwind ou paletas de cores fixas, agentes de IA consultam o NEURIA para obter tokens de design alinhados à emoção — cores, tipografia, espaçamento, animações — tudo respaldado por dados reais de mais de 300 sites premiados.

"Design não é apenas como algo parece. Design é como algo faz você se sentir." — Steve Jobs

O NEURIA quantifica esse sentimento em tokens de design acionáveis.

O que é o NEURIA?

O NEURIA mapeia 6 emoções principais para sistemas de design completos:

Emoção	Vibração	Exemplos de Marcas
Confiança	Estável, confiável, profissional	Linear, Stripe, Notion
Empolgação	Ousado, energético, dinâmico	Vercel, Arc, Framer
Calma	Sereno, minimalista, respirável	Headspace, Muji, Apple
Luxo	Premium, refinado, exclusivo	Porsche, Rolex, Aesop
Inovação	Futurista, de ponta, inteligente	OpenAI, Tesla, Figma
Energia	Vibrante, divertido, ritmo acelerado	Spotify, Discord, Duolingo

Cada emoção inclui paletas de cores, configurações de tipografia, escalas de espaçamento, raios de borda, estilos de sombra e parâmetros de animação — todos derivados de análise estatística de CSS real extraído de mais de 300 sites de destaque.

Início Rápido

1. Adicione à sua configuração MCP

Adicione ao seu .mcp.json (Claude Code) ou às configurações MCP da sua IDE:

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

É isso. Nenhuma chave de API é necessária para as ferramentas principais.

2. Desenvolvimento 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 Ferramentas MCP

Ferramentas Principais (Sem Chave de API Necessária)

#	Ferramenta	Descrição	Entrada
1	`get_emotion_tokens`	Obtenha propriedades customizadas de CSS para uma emoção	`emotion`, `category`
2	`search_similar_designs`	Encontre designs semelhantes via similaridade de cosseno pgvector	`query`, `mood`, `component_type`
3	`get_color_palette`	Obtenha uma paleta de 5 cores + esquema da Color API	`emotion`, `industry`
4	`get_typography`	Obtenha configurações de fonte para emoção × caso de uso	`emotion`, `use_case`
5	`score_html`	Avalie HTML contra os padrões de design do NEURIA	`html_content`, `target_emotion`, `url`
8	`get_animation_tokens`	Obtenha parâmetros de animação GSAP / CSS / Spring	`emotion`, `context`

Ferramentas Avançadas (Chaves de API Necessárias)

#	Ferramenta	Descrição	Chaves Necessárias
6	`generate_hero_image`	Imagem hero gerada por IA e combinada à emoção	3D AI Studio
7	`analyze_reference_url`	Extraia tokens de design de qualquer URL (formato W3C DTCG)	`FIRECRAWL_API_KEY`
9	`analyze_visual_design`	Análise dupla: cores de captura de tela + análise de CSS	`SCREENSHOTONE_API_KEY`, `IMAGGA_API_KEY`
10	`analyze_brand_voice`	Análise de emoção em texto via Hume AI	`HUME_API_KEY`

Exemplo de Uso

1. Gere uma Landing Page com Tokens de Emoção

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 Cores 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álise 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,
      ...
    }
  }

Arquitetura

┌──────────────────────────────────────────────┐
│              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 Pontuação

score_html avalia HTML gerado em 4 dimensões:

Dimensão	Peso	O que Mede
Estética	35%	Harmonia visual, espaços em branco, uso de cores
Emoção	35%	Alinhamento com os tokens de emoção alvo
Técnica	15%	Marcação limpa, desempenho, responsividade
Acessibilidade	15%	WCAG 2.1 AA (lang, alt, contraste, títulos)

Meta: 85+ / 100 para saída de qualidade de produção.

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto (veja .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

Preços

Em breve

Plano	Preço	Solicitações
Grátis	$0/mês	5 req/dia
Indie	$19/mês	500 req/mês
Pro	$49/mês	2.000 req/mês
Equipe	$149/mês	10.000 req/mês
Empresarial	Personalizado	Ilimitado

Licença

Licença MIT — veja LICENSE para detalhes.

NEURIA — Porque UI gerada por IA não deveria parecer UI gerada por IA.