emap-mcp — movilidad hiperlocal de Euskadi para agentes

Servidor MCP (roadmap L5) sobre los endpoints públicos de emap / API actual. No existe otro MCP de movilidad hiperlocal: búsqueda semántica local ES/EU, contexto de lugar, rutas multimodales con infraestructura propia (OSRM/OTP) y "el monte en transporte público".

Versión: 0.1.2 · wrapper de solo lectura · Apache-2.0

Herramientas

Toda respuesta incluye attribution (ODbL + GTFS oficiales + CC-BY-4.0). Principio NO SE FINGE: si la API no sabe, la herramienta lo dice.

Related MCP server: @cargoffer/zbe-mcp

Uso con Claude Desktop (stdio local)

{
  "mcpServers": {
    "emap": {
      "command": "/ruta/a/emap-labs/.venv/bin/python",
      "args": ["/ruta/a/emap-labs/mcp/server.py"]
    }
  }
}

Requisitos: python -m pip install mcp httpx (o el venv del repo). El servidor habla stdio y consume la API pública — no necesita credenciales.

Modo HTTP (VPS, sin instalación local)

EMAP_MCP_TRANSPORT=streamable-http EMAP_MCP_PORT=8084 python mcp/server.py

./mcp/deploy.sh lo deja en el VPS (systemd emap-mcp, 127.0.0.1:8084).

Cliente remoto (después del redeploy y smoke verde):

{"mcpServers": {"emap": {"url": "https://vps.emapapp.com/mcp"}}}

Variables de entorno

Snippet nginx (path o subdominio): nginx.example.conf.

Verificación

• 2026-07-10 — cliente MCP stdio real → nearby_pois(bikepark, San Mamés) → aparcabicis a 47 m con atribución (criterio L5.1). Las 5 herramientas probadas contra producción.

• Post-deploy — deploy.sh hace GET /health + initialize JSON-RPC en localhost:8084.

• Smoke automatizado (mcp/smoke.py):

# local (servidor en :8084)
EMAP_MCP_TRANSPORT=streamable-http .venv/bin/python mcp/server.py &
.venv/bin/python mcp/smoke.py --base http://127.0.0.1:8084

# endpoint objetivo (requiere redeploy y smoke verde)
.venv/bin/python mcp/smoke.py --base https://vps.emapapp.com --live

# cuando exista el dominio de producto
.venv/bin/python mcp/smoke.py --base https://mcp.emapapp.com --live

Distribución (L5.3)

• Registro oficial MCP: io.github.r3tr0eth/emap (registry.modelcontextprotocol.io, remote streamable-http, status active — 2026-07-10). server.json en este directorio.

• server.json prepara vps.emapapp.com/mcp, pero no debe republicarse en el registry hasta que el redeploy termine con smoke verde. El dominio anterior continúa en la allowlist durante la transición.

• llms.txt del API: https://emap-next.vercel.app/llms.txt

• Pendiente: PR a awesome-mcp-servers y post técnico (borradores listos); migrar URL pública a dominio emapapp.com.