USGS Quakes

usgs-quakes-mcp

Servidor MCP para el catálogo de terremotos del USGS

Un servidor MCP que proporciona acceso a la API de eventos FDSN del USGS desde Claude Desktop, Claude Code y cualquier otro cliente MCP.

npx -y usgs-quakes-mcp

No se requiere clave de API — el servicio del USGS es gratuito y público.

Descripción general

Este servidor del Model Context Protocol (MCP) permite a asistentes de IA y aplicaciones:

• Obtener datos de terremotos mediante una amplia variedad de parámetros de búsqueda
• Obtener detalles sobre un terremoto específico

Los usuarios pueden ejecutar consultas en lenguaje natural.

Ejemplo de salida

P: encuentra terremotos de magnitud superior a 2 en Florida en los últimos 20 años

R: Te ayudaré a buscar terremotos en Florida con una magnitud superior a 2.0 en los últimos 20 años.

Ver resultado de find-earthquakes de usgs-quakes (local)

{
  "endTime": "2024-12-28T23:59:59",
  "startTime": "2004-12-28T00:00:00",
  "maxLatitude": 31.000888,
  "minLatitude": 24.396308,
  "maxLongitude": -80.031362,
  "minLongitude": -87.634896,
  "minmagnitude": 2
}

Según los datos de terremotos del USGS, ha habido tres terremotos notables en Florida o cerca de ella durante los últimos 20 años:

1. Un terremoto de magnitud 5.9 en el golfo de México el 10 de septiembre de 2006 Ubicado en aguas profundas en las coordenadas 26.319°N, 86.606°O Profundidad: 14 km Fue el terremoto más grande de la región durante este período Se sintió ampliamente; 5,763 personas informaron haber sentido el sismo

2. Un terremoto de magnitud 2.8 cerca de Jay, Florida, el 6 de marzo de 2019 Ubicado en las coordenadas 30.9718°N, 87.1719°O Profundidad: 5 km 49 personas informaron haber sentido este terremoto

3. Un terremoto de magnitud 2.7 cerca de Century, Florida, el 24 de marzo de 2019 Ubicado en las coordenadas 30.9622°N, 87.2384°O Profundidad: 5 km 4 personas informaron haber sentido este terremoto

Vale la pena señalar que Florida experimenta relativamente pocos terremotos en comparación con regiones sísmicamente más activas de Estados Unidos. Los dos terremotos de 2019 ocurrieron en el panhandle de Florida, mientras que el evento más grande de 2006 fue en aguas profundas del golfo de México.

P: obtén los detalles del terremoto de Jay, Florida

R: Obtendré la información detallada sobre el terremoto de magnitud 2.8 que ocurrió cerca de Jay, Florida.

Ver resultado de find-earthquake-details de usgs-quakes (local)

{
  "eventid": "us1000jbw4"
}

Aquí están los detalles clave sobre el terremoto de Jay, Florida: Fecha y hora: 7 de marzo de 2019, a las 04:45:52 UTC Ubicación: 2 km (1.2 millas) al noroeste de Jay, Florida Coordenadas: 30.9718°N, 87.1719°O Profundidad: 5 kilómetros (3.1 millas) Magnitud: 2.8 mb_lg (magnitud de onda corporal)

Detalles adicionales:

• 49 personas informaron haber sentido el terremoto
• El Mapa de Intensidad de Internet Comunitario (CIIM) mostró una intensidad máxima de 2.7
• No se generó ningún tsunami
• El terremoto fue revisado y confirmado por científicos del USGS
• La ubicación tenía un margen de error horizontal de aproximadamente 6.2 km
• El cálculo de la magnitud utilizó datos de 11 estaciones sísmicas
• El terremoto también fue detectado por la red sísmica de Nuevo México (NM), que calculó una magnitud ligeramente diferente de 2.63

Mediciones técnicas:

• Brecha azimutal: 243 grados (indica una cobertura moderada por estaciones sísmicas)
• Error RMS: 0.59 (indica una calidad razonable de la estimación de ubicación)
• Distancia mínima a la estación más cercana: 0.222 grados
• Error estándar de la magnitud: 0.154

Este fue un terremoto relativamente menor, pero notable para Florida, que rara vez experimenta actividad sísmica. El hecho de que fuera sentido por 49 personas sugiere que fue perceptible para los residentes del área inmediata, aunque no se esperarían daños significativos de un terremoto de esta magnitud.

Instalación

Requiere Node.js 20 o superior. No se necesita paso de instalación — npx obtiene el servidor en la primera ejecución.

Claude Desktop

1. Abre tu configuración de Claude Desktop en:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade la configuración del servidor:

{
    "mcpServers": {
        "usgs-quakes": {
            "command": "npx",
            "args": ["-y", "usgs-quakes-mcp"]
        }
    }
}

3. Cierra/Sal de Claude Desktop y luego reinícialo

Claude Code

claude mcp add usgs-quakes -- npx -y usgs-quakes-mcp

Cualquier otro cliente MCP

El servidor habla MCP a través de STDIO. Ejecútalo con npx -y usgs-quakes-mcp, o instálalo globalmente con npm install -g usgs-quakes-mcp y ejecuta usgs-quakes-mcp.

Herramientas

• find-earthquakes — busca por tiempo, cuadro delimitador, radio, magnitud y profundidad
• count-earthquakes — cuenta coincidencias sin devolver eventos, para dimensionar una consulta primero
• find-earthquake-details — detalle completo para un ID de evento, incluidos los indicadores de calidad del origen

Fuente de datos

Los datos provienen del servicio web de eventos FDSN del USGS. El servicio limita cualquier consulta individual a 20,000 eventos.

Desarrollo

npm install        # install dependencies
npm run dev        # run from source over STDIO, no build step
npm run build      # compile TypeScript to build/
npm run typecheck  # type-check without emitting

src/server.ts contiene todas las herramientas y llamadas a la API — ese es el archivo a editar. src/index.ts es solo el punto de entrada de STDIO.

Para apuntar Claude Desktop a una compilación local en lugar del paquete publicado, usa "command": "node" con "args": ["/full/path/to/usgs-quakes/build/index.js"], y reinicia Claude Desktop después de cada recompilación.

Solución de problemas

Si Claude Desktop no puede encontrar npx, proporciona su ruta completa (en macOS, normalmente /usr/local/bin/npx o /opt/homebrew/bin/npx). Lo mismo se aplica a node si estás ejecutando una compilación local.