SportFinder Pro Backend + MCP Server

Backend para un buscador inteligente de tiendas de artículos deportivos. Permite encontrar tiendas cercanas y filtrar por ubicación, tipo de artículo, deporte, distancia, estado abierto y disponibilidad. Los resultados se ordenan por relevancia.

Características

• API REST con FastAPI.

• Servidor MCP sobre HTTP en /mcp.

• Búsqueda inteligente con ranking por distancia, calificación, inventario, texto, filtros y servicios.

• Soporte para tres idiomas: español, inglés y francés.

• Contrato visual moderno en /api/v1/theme.

• Datos iniciales simulados para Bogotá, Medellín y Cali.

• Configuración lista para Render mediante render.yaml.

Related MCP server: Shopify Storefront MCP Server

Ejecutar localmente

python -m venv .venv
pip install -r requirements.txt
uvicorn app.main:app --host 127.0.0.1 --port 8000 --reload

URLs locales:

Backend REST:   http://127.0.0.1:8000
Documentación: http://127.0.0.1:8000/docs
Servidor MCP:  http://127.0.0.1:8000/mcp
Health check:  http://127.0.0.1:8000/health

Endpoints principales

Herramientas MCP

• search_sports_stores

• get_store_details

• check_item_availability

• get_filter_options

Despliegue en Render

Configuración manual equivalente:

Runtime: Python
Build Command: pip install -r requirements.txt
Start Command: uvicorn app.main:app --host 0.0.0.0 --port $PORT
Health Check Path: /health

Después del despliegue, el servidor MCP público quedará así:

https://NOMBRE-DEL-SERVICIO.onrender.com/mcp

Pruebas

pytest -q