Claude MCP Server for USGS Quakes API

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Serves as the runtime environment for the MCP server, enabling it to process requests and communicate with the USGS Quakes API

USGS-Terremotos-MCP

Servidor Claude MCP para la API de terremotos del USGS

Una implementación de servidor MCP para proporcionar acceso a la API de terremotos del USGS dentro de Claude Desktop .

Descripción general

Este servidor de Protocolo de Contexto de Modelo (MCP) permite que los asistentes y aplicaciones de IA:

  • Obtenga datos de terremotos a través de una amplia variedad de parámetros de búsqueda
  • Obtenga detalles sobre un terremoto específico

Los usuarios pueden ejecutar consultas utilizando lenguaje natural.

Salida de muestra

P: ¿Se encontraron terremotos de magnitud superior a 2 en Florida durante los últimos 20 años?

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

Ver resultados 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 allí en 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 alta mar en las coordenadas 26.319°N, 86.606°O Profundidad: 14 km Este fue el terremoto más grande en la región durante este período Se sintió ampliamente, con 5.763 personas reportando haber sentido el terremoto
  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

Cabe destacar que Florida experimenta relativamente pocos terremotos en comparación con regiones con mayor actividad sísmica de Estados Unidos. Los dos terremotos de 2019 ocurrieron en el Panhandle de Florida, mientras que el terremoto más grande de 2006 se produjo en alta mar, en el Golfo de México.

P: Obtenga 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 resultados 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 reportaron haber sentido el sismo
  • El Mapa de Intensidad de Internet Comunitaria (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 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.

Medidas técnicas:

  • Brecha azimutal: 243 grados (indica una cobertura moderada por parte de las estaciones sísmicas)
  • Error RMS: 0,59 (indica una calidad razonable de la estimación de la ubicación)
  • Distancia mínima a la estación más cercana: 0,222 grados
  • Error estándar de magnitud: 0,154

Este fue un terremoto relativamente leve, pero notable en Florida, donde rara vez se registra actividad sísmica. El hecho de que lo sintieran 49 personas sugiere que fue perceptible para los residentes de la zona, aunque no se esperarían daños significativos de un terremoto de esta magnitud.

Instalación

Instalación mediante herrería

Para instalar USGS Earthquake Data para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @blake365/usgs-quakes-mcp --client claude

Instalación manual

Instalar esto puede ser complicado si no está familiarizado con Node.js y el protocolo MCP.

  1. Instalar Node.js
  2. Clona este repositorio en una carpeta en tu máquina local
  3. El servidor ya está construido, por lo que puedes omitir el paso de compilación.

Pasos adicionales

Si desea realizar cambios en el servidor, puede hacerlo editando el archivo src/index.ts .

  • Ejecute npm install para instalar las dependencias
  • Ejecute npm run build para compilar el servidor
  • Salga y reinicie Claude Desktop después de realizar cambios

Conectando con Claude Desktop

  1. Abra la configuración de Claude Desktop en:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
  2. Agregue la configuración del servidor:
{ "mcpServers": { "usgs-quakes": { "command": "node", "args": [ "/Full/Route/to/Folder/usgs-quakes/build/index.js" ] } } }
  1. Cierre/Salga y luego reinicie Claude Desktop

Al reiniciar, debería ver un pequeño icono de martillo en la esquina inferior derecha del cuadro de texto. Si pasa el cursor sobre él, verá la cantidad de herramientas MCP disponibles.

Solución de problemas

Si se producen errores al ejecutar el servidor, es posible que deba proporcionar la ruta completa del comando node . Por ejemplo, en macOS: /usr/local/bin/node

-
security - not tested
A
license - permissive license
-
quality - not tested

Proporciona acceso a la API de terremotos del USGS dentro de Claude Desktop, lo que permite a los usuarios recuperar datos y detalles de terremotos a través de consultas en lenguaje natural.

  1. Overview
    1. Sample Output
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
        3. Extra Steps
      2. Connecting with Claude Desktop
        1. Troubleshooting
          ID: vhd9mjkxya