bbox-mcp-server

🌍 bbox-mcp-server

Pregúntale a la IA sobre cualquier cosa, en cualquier lugar — y verifica la respuesta en un mapa. Gratis

El kit de herramientas geoespaciales para agentes de IA. 6 herramientas, cero configuración — dale a cualquier LLM la capacidad de encontrar, consultar, convertir y agregar datos espaciales usando datos abiertos. No se requieren claves API ni registros para comenzar.

Cada respuesta incluye un enlace de verificación compartible a vibhorsingh.com/boundingbox — haz clic para confirmar visualmente los resultados en un mapa interactivo. Ningún otro servidor MCP hace esto.

¿Qué Puedes Hacer Con Esto?

No tienes que ser un profesional de GIS para aprovecharlo. Cualquier agente de IA con este servidor MCP puede responder preguntas espaciales usando datos reales de OpenStreetMap y no escupir basura alucinada.

Cada respuesta viene con un enlace. Haz clic, comprueba si la IA acertó y también puedes compartirlo con otra persona.

Qué Hace Esto Diferente

La mayoría de las herramientas de IA te dan texto en el que tienes que confiar. Esta te da un mapa interactivo que puedes comprobar y verificar.

• Verificable — Cada respuesta incluye una URL pública donde tú (o cualquier persona) pueden confirmar visualmente los resultados. Este es el único servidor MCP que hace esto en cualquier dominio.
• Determinista — Las consultas acceden a datos reales de OpenStreetMap y devuelven coordenadas reales. La IA interpreta tu pregunta. Los datos provienen de todo el trabajo duro de los increíbles voluntarios de OSM.
• Gratis — Sin servicios de pago. La API de Overpass es gratuita, los datos de OSM son gratuitos, la herramienta es gratuita. Un token de Mapbox (nivel gratuito, sin información de pago) desbloquea la búsqueda de ubicaciones en lenguaje natural, pero no es obligatorio.
• Cero configuración — npx -y bbox-mcp-server y ya estás en marcha.

Por Qué Existe Esto

Herramientas de un Vistazo

Todas las herramientas aceptan location (lenguaje natural, requiere token de Mapbox) o bbox (coordenadas, WKT, GeoJSON, etc.).

Inicio Rápido

Añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "servers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

Prueba: "Encuentra todas las cafeterías a menos de 500 m de Times Square"

Configuración Opcional

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "pk.your-token-here",
        "OVERPASS_API_URL": "https://your.custom.overpass.instance/api/interpreter",
        "NOMINATIM_API_URL": "https://your.custom.nominatim.instance"
      }
    }
  }
}

O instala globalmente: npm install -g bbox-mcp-server

Referencia de Herramientas

get_bounds

Convierte y proyecta un bounding box entre 6 formatos de entrada, 9 formatos de salida y más de 3,900 sistemas de coordenadas. Devuelve el punto central y las coordenadas de teselas para el centroide.

💡 Sugerencia: "Obtén el bounding box de Central Park en formato WKT proyectado a EPSG:32618"

get_h3_indices

Genera índices de celdas hexagonales de Uber H3 que cubren un bounding box.

💡 Sugerencia: "Dame celdas H3 a resolución 7 para el centro de Chicago, incluye las geometrías hexagonales"

search_overpass

Ejecuta una consulta Overpass dentro de un bounding box o radio. Devuelve resultados estructurados con nombres, coordenadas y etiquetas. El enlace de verificación coloca cada resultado como un pin en el mapa.

💡 Sugerencia: "Encuentra todos los estacionamientos a menos de 2 km del aeropuerto JFK"

💡 Sugerencia: "Busca hospitales en Manhattan, límite 50"

list_osm_tags

Busca las etiquetas correctas de OpenStreetMap para una categoría antes de escribir una consulta Overpass.

💡 Sugerencia: "¿Cuáles son las etiquetas OSM correctas para supermercados?"

aggregate_overpass_h3

Ejecuta una consulta Overpass y agrupa los resultados en hexágonos H3 para análisis de densidad espacial. Devuelve recuentos por celda y límites hexagonales GeoJSON.

💡 Sugerencia: "Agrega todos los hospitales de Seattle en contenedores H3 a resolución 7"

generate_share_url

Genera un enlace compartible para visualizar un bounding box en el mapa interactivo en vibhorsingh.com/boundingbox.

💡 Sugerencia: "Genera un enlace para compartir del bbox 40.7128,-74.0060,40.7580,-73.9855"

Formatos de Entrada Compatibles

Todas las herramientas detectan automáticamente el formato de entrada. No es necesario especificar cuál estás usando.

🤖 Para Desarrolladores de Agentes de IA

Estructura de respuesta

Cada herramienta devuelve dos bloques de contenido:

1. Texto legible para humanos — salida formateada con el enlace de verificación en mapa
2. JSON estructurado — todos los datos calculados, analizables por máquina

Ejemplo de respuesta JSON get_bounds:

{
  "original_wgs84": { "lat1": 40.7128, "lng1": -74.006, "lat2": 40.758, "lng2": -73.9855 },
  "projected": { "xmin": -8238310.23, "ymin": 4970241.32, "xmax": -8235527.11, "ymax": 4976491.56 },
  "center": { "lat": 40.7354, "lng": -73.99575 },
  "tile_indices": { "z": 15, "x": 9660, "y": 12284 },
  "epsg": "3857",
  "coord_order": "lng,lat",
  "area_km2": 8.681,
  "dimensions": { "width_km": 1.714, "height_km": 5.066 },
  "share_url": "https://vibhorsingh.com/boundingbox/#40.712800,-74.006000,40.758000,-73.985500"
}

Manejo de errores

Todos los errores devuelven isError: true con un mensaje descriptivo. Coordenadas inválidas, códigos EPSG desconocidos y solicitudes H3 sobredimensionadas devuelven errores limpios — el servidor nunca falla con entrada incorrecta.

Registro

Los registros JSON estructurados van a stderr (stdout está reservado para el protocolo MCP). Cada entrada incluye marca de tiempo, nivel y contexto.

Agradecimientos y Uso Justo

OpenStreetMap

Esta herramienta está construida sobre OpenStreetMap: un conjunto de datos global creado y mantenido por millones de voluntarios. Cada consulta que ejecutas devuelve datos que alguien caminó, mapeó o verificó a mano. Si encuentras esto útil, considera contribuir a OSM.

Uso Responsable

Las instancias públicas de las API de Overpass y Nominatim son recursos comunitarios gratuitos con capacidad limitada. Evita bucles cerrados, sondeos excesivos o extracción masiva de datos. Si alojas esto como un servidor MCP compartido/remoto, apunta NOMINATIM_API_URL y OVERPASS_API_URL a tu propia instancia o a un proveedor comercial (consulta instalación de Overpass API e instalación de Nominatim). La rotación predeterminada del servidor para Overpass ayuda a distribuir la carga, pero no sustituye un uso responsable.

Licencia

MIT