brandfetch MCP

Servidor MCP de Brandfetch

El Protocolo de Contexto de Modelo oficial para Brandfetch. Proporciona a los asistentes de IA acceso a búsqueda de marcas, datos de empresas, logotipos y recursos de diseño, y contexto de marca listo para LLM desde la API de Brandfetch.

Documentación completa: https://docs.brandfetch.com/mcp/overview

Herramientas

Herramienta	Descripción
brand_search	Busca marcas por nombre utilizando el índice de búsqueda de Brandfetch.
get_brand	Consulta datos completos de la marca por dominio, símbolo bursátil, ISIN o símbolo criptográfico.
enrich_transaction	Identifica una marca comercial a partir de una cadena de tarjeta de crédito o extracto bancario.
get_brand_context	Obtén contexto de marca listo para LLM para un dominio: voz, audiencia, posicionamiento, estilo.
build_logo_urls	Construye URLs del CDN de logotipos de Brandfetch para una o más marcas (sin llamada a la API).
get_asset_base64	Obtén un recurso del CDN de Brandfetch (logotipo, icono, símbolo, imagen) como base64.
send_feedback	Envía comentarios sobre el servidor MCP al equipo de Brandfetch.

Inicio rápido (servidor alojado)

La forma más sencilla de usar este servidor es conectarse al endpoint alojado por Brandfetch: sin instalación, sin infraestructura:

https://mcp.brandfetch.io/mcp

La autenticación utiliza un token MCP de Brandfetch (un token de portador bf1.). Genera uno desde la página Keys and MCP en el panel de Brandfetch, o conéctate mediante OAuth desde un cliente que lo admita.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "brandfetch": {
      "type": "http",
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Cursor

Agrega a ~/.cursor/mcp.json (o al .cursor/mcp.json del proyecto):

{
  "mcpServers": {
    "brandfetch": {
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Los clientes que admiten OAuth pueden, en su lugar, apuntar a https://mcp.brandfetch.io/mcp sin token y completar el flujo de autorización en el navegador.

Autoalojamiento

Este es un servidor MCP HTTP (streamable-http) construido con FastMCP. Puedes ejecutar tu propia instancia con Docker.

docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server

El servidor escucha entonces en http://localhost:8080/mcp. Apunta tu cliente MCP a esa URL y envía tus credenciales de Brandfetch como un token Bearer.

El Dockerfile incluye el AWS Lambda Web Adapter y algunas variables de entorno AWS_LWA_*. Son inertes fuera de AWS Lambda y pueden ignorarse (o eliminarse) para una implementación simple en contenedor/host.

Ejecución sin Docker

uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080

Desarrollo

Requiere uv y Python 3.11.

uv sync                 # install dependencies
uv run pytest           # run the tests
uv run ruff check .     # lint
uv run ruff format .    # format

Licencia

MIT