Vincario Vehicle Data

Servidor MCP de Vincario

Un servidor MCP (Protocolo de Contexto de Modelo) que expone la API de Vincario a agentes de IA y clientes LLM. Permite a los asistentes de IA decodificar VINs, consultar bases de datos de vehículos robados y obtener valoraciones de mercado mediante lenguaje natural.

Herramientas

Herramienta	Descripción
vin_decode	Decodifica un VIN y devuelve información detallada del vehículo
vin_decode_info	Lista los campos disponibles para un VIN dado (endpoint gratuito)
stolen_check	Comprueba si un VIN aparece en bases de datos de vehículos robados
vehicle_market_value	Obtén la valoración de mercado de un vehículo (admite entrada de odómetro)

Requisitos

• Clave de API de Vincario — se pasa mediante el encabezado HTTP X-API-Key
• Docker (recomendado), o Python 3.11+ con uv

Ejecución con Docker

docker build -t vincario-mcp .
docker run -p 8080:8080 vincario-mcp

El servidor se inicia en http://localhost:8080.

Ejecución local

pip install uv
uv sync
uv run main.py

Conexión a un cliente MCP

Pasa tu clave de API de Vincario como encabezado HTTP en cada solicitud:

X-API-Key: your_api_key_here

Claude Code

Agrégalo a tu configuración de MCP (.mcp.json o claude_desktop_config.json):

{
  "mcpServers": {
    "vincario": {
      "type": "http",
      "url": "http://localhost:8080",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

Endpoint alojado

Si te conectas al servidor alojado en https://mcp.vincario.com/mcp, reemplaza la URL en consecuencia.

Ejemplo de uso

Una vez conectado, puedes preguntarle a tu asistente de IA:

• "Decodifica el VIN WBAFR9C54BC780006"
• "¿Está este vehículo robado? VIN: WBAFR9C54BC780006"
• "¿Cuál es el valor de mercado del VIN WBAFR9C54BC780006 con 85000 km?"

Transporte

El servidor utiliza transporte HTTP transmisible (stateless_http=True), lo que significa que no se requiere una sesión persistente. Cada solicitud es independiente, lo que facilita su despliegue detrás de un proxy inverso o balanceador de carga.

Para despliegue con HTTPS, coloca un proxy inverso (nginx, Caddy, Cloudflare) frente al servidor — la aplicación se ejecuta en el puerto HTTP 8080.

Licencia

Consulta los Términos de servicio de la API de Vincario para conocer las condiciones de uso.