Design Brief Generator Provider

Un proveedor TypeScript independiente y local-first que genera un brief de diseño estructurado a partir de una URL de sitio web y/o detalles de marca. La salida es determinista, está disponible en inglés (en) y español (es), y se expone tanto mediante una función directa como mediante un manejador con forma de MCP para JSON-RPC 2.0.

Este es un proveedor independiente. No se conecta a Stellar Bazaar ni lo modifica, y no requiere secretos, credenciales de pago ni carteras.

Requisitos

• Node.js 22.6 o superior (se recomienda Node 24)

• Sin dependencias de tiempo de ejecución

Related MCP server: mcp-mirage-brand-extract

Inicio rápido

npm test
npm run build
npm run audit:files
npm run example

En Windows PowerShell con la ejecución de scripts deshabilitada, usa npm.cmd test. La salida compilada se escribe en dist/, que está ignorado, y nunca se hace commit ni se sube a Vercel.

import { generateDesignBrief } from "./src/index.ts";

const result = generateDesignBrief({
  url: "https://example.com",
  locale: "es",
  brand: {
    name: "Marca Ejemplo",
    industry: "tecnología",
    audience: ["Equipos de producto"],
    values: ["Claridad", "Confianza"],
    colors: ["#101828", "#7F56D9"]
  }
});

Se requiere al menos uno de url o brand.name. Una URL proporciona un nombre de host humanizado cuando el nombre de la marca está ausente. El proveedor no obtiene la URL; la usa únicamente como entrada local, lo que mantiene el comportamiento de los fixtures seguro y reproducible.

Contrato

generateDesignBrief(input) devuelve ProviderResult<DesignBrief>: o bien { ok: true, data } o bien { ok: false, error }. El brief de diseño incluye objetivos y restricciones del proyecto, estrategia de marca y dirección visual, principios de experiencia, recomendaciones de páginas, entregables, métricas y supuestos explícitos.

El manejador con forma de MCP admite:

• initialize

• tools/list

• tools/call con generate_design_brief

import { handleMcpRequest } from "./src/index.ts";

const response = handleMcpRequest({
  jsonrpc: "2.0",
  id: 1,
  method: "tools/call",
  params: {
    name: "generate_design_brief",
    arguments: { url: "https://example.com", locale: "en" }
  }
});

Este es un adaptador de protocolo en proceso, no un servidor de red. Un host puede asignarlo a stdio o HTTP sin cambiar el contrato de generación. Los metadatos del proveedor también están disponibles en service-card.json y como la constante exportada serviceCard.

API HTTP

El despliegue en Vercel expone el mismo contrato local:

Producción: https://design-brief-provider.vercel.app

• GET / — descubrimiento de servicios y esquema de Tool

• GET /health — respuesta de salud y versión

• POST /api — GenerateBriefInput directo, que devuelve ProviderResult<DesignBrief>

• POST /api — solicitud JSON-RPC 2.0 para el adaptador con forma de MCP

curl -X POST https://design-brief-provider.vercel.app/api \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","locale":"es"}'

La URL se trata solo como metadatos; el proveedor no realiza ninguna obtención de sitios web saliente.

Despliegue en Vercel

Importa este repositorio como un nuevo proyecto de Vercel con el ajuste preestablecido de framework predeterminado. No se requieren variables de entorno, base de datos, salida de compilación, pagos ni configuración de cartera. Los manejadores api/ y las reescrituras de vercel.json están listos para el despliegue.

Desarrollo

npm test
npm run build
npm run audit:files
npm run example

El conjunto de pruebas cubre la entrada de URL determinista, la entrada de marca en español, los errores de validación, el descubrimiento y la invocación con forma de MCP. El archivo fixtures/stellar-brief.es.json incluido en el repositorio es una salida de muestra local estable y el conjunto de pruebas lo comprueba.

Licencia

Licencia Apache 2.0. Consulta LICENSE.