USGS Quakes

usgs-quakes-mcp

Servidor MCP para o catálogo de terremotos do USGS

Um servidor MCP que fornece acesso à API de eventos FDSN do USGS a partir do Claude Desktop, Claude Code e qualquer outro cliente MCP.

npx -y usgs-quakes-mcp

Nenhuma chave de API necessária — o serviço do USGS é gratuito e público.

Visão Geral

Este servidor Model Context Protocol (MCP) permite que assistentes de IA e aplicativos:

• Obtenham dados de terremotos por meio de uma ampla variedade de parâmetros de busca
• Obtenham detalhes sobre um terremoto específico

Os usuários podem executar consultas em linguagem natural.

Exemplo de Saída

P: encontre terremotos de magnitude superior a 2 na Flórida nos últimos 20 anos

R: Vou ajudá-lo a buscar terremotos na Flórida com magnitude superior a 2,0 nos últimos 20 anos.

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
}

Com base nos dados de terremotos do USGS, houve três terremotos notáveis na Flórida ou nas proximidades nos últimos 20 anos:

1. Um terremoto de magnitude 5,9 no Golfo do México em 10 de setembro de 2006 Localizado no mar nas coordenadas 26,319°N, 86,606°O Profundidade: 14 km Este foi o maior terremoto da região durante esse período Foi amplamente sentido, com 5.763 pessoas relatando ter sentido o tremor

2. Um terremoto de magnitude 2,8 perto de Jay, Flórida, em 6 de março de 2019 Localizado nas coordenadas 30,9718°N, 87,1719°O Profundidade: 5 km 49 pessoas relataram ter sentido este terremoto

3. Um terremoto de magnitude 2,7 perto de Century, Flórida, em 24 de março de 2019 Localizado nas coordenadas 30,9622°N, 87,2384°O Profundidade: 5 km 4 pessoas relataram ter sentido este terremoto

Vale notar que a Flórida experimenta relativamente poucos terremotos em comparação com regiões mais sismicamente ativas dos Estados Unidos. Os dois terremotos de 2019 ocorreram no panhandle da Flórida, enquanto o evento maior de 2006 foi no mar, no Golfo do México.

P: obtenha os detalhes do terremoto de Jay, Flórida

R: Vou obter as informações detalhadas sobre o terremoto de magnitude 2,8 que ocorreu perto de Jay, Flórida.

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

{
  "eventid": "us1000jbw4"
}

Aqui estão os principais detalhes sobre o terremoto de Jay, Flórida: Data e Hora: 7 de março de 2019, às 04:45:52 UTC Localização: 2 km (1,2 milhas) a noroeste de Jay, Flórida Coordenadas: 30,9718°N, 87,1719°O Profundidade: 5 quilômetros (3,1 milhas) Magnitude: 2,8 mb_lg (magnitude de onda de corpo)

Detalhes adicionais:

• 49 pessoas relataram ter sentido o terremoto
• O Mapa de Intensidade da Internet Comunitária (CIIM) mostrou uma intensidade máxima de 2,7
• Não houve geração de tsunami
• O terremoto foi revisado e confirmado por cientistas do USGS
• A localização teve uma margem de erro horizontal de cerca de 6,2 km
• O cálculo da magnitude usou dados de 11 estações sísmicas
• O terremoto também foi detectado pela rede sísmica do Novo México (NM), que calculou uma magnitude ligeiramente diferente de 2,63

Medições técnicas:

• Lacuna azimutal: 243 graus (indica cobertura moderada pelas estações sísmicas)
• Erro RMS: 0,59 (indica qualidade razoável da estimativa de localização)
• Distância mínima até a estação mais próxima: 0,222 graus
• Erro padrão para magnitude: 0,154

Este foi um terremoto relativamente menor, mas notável para a Flórida, que raramente experimenta atividade sísmica. O fato de ter sido sentido por 49 pessoas sugere que foi perceptível para os moradores da área imediata, embora não se esperassem danos significativos de um terremoto dessa magnitude.

Instalação

Requer Node.js 20 ou mais recente. Nenhuma etapa de instalação é necessária — npx busca o servidor na primeira execução.

Claude Desktop

1. Abra a configuração do Claude Desktop em:

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

2. Adicione a configuração do servidor:

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

3. Feche/Saia e reinicie o Claude Desktop

Claude Code

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

Qualquer outro cliente MCP

O servidor fala MCP via STDIO. Execute-o com npx -y usgs-quakes-mcp, ou instale-o globalmente com npm install -g usgs-quakes-mcp e execute usgs-quakes-mcp.

Ferramentas

• find-earthquakes — busca por tempo, caixa delimitadora, raio, magnitude e profundidade
• count-earthquakes — conta correspondências sem retornar eventos, para dimensionar uma consulta primeiro
• find-earthquake-details — detalhes completos para um ID de evento, incluindo métricas de qualidade de origem

Fonte de dados

Os dados vêm do serviço web de eventos FDSN do USGS. O serviço limita qualquer consulta única a 20.000 eventos.

Desenvolvimento

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 contém todas as ferramentas e chamadas de API — esse é o arquivo a ser editado. src/index.ts é apenas o ponto de entrada STDIO.

Para apontar o Claude Desktop para uma compilação local em vez do pacote publicado, use "command": "node" com "args": ["/full/path/to/usgs-quakes/build/index.js"] e reinicie o Claude Desktop após cada recompilação.

Solução de problemas

Se o Claude Desktop não conseguir encontrar npx, forneça o caminho completo (no macOS, normalmente /usr/local/bin/npx ou /opt/homebrew/bin/npx). O mesmo se aplica a node se você estiver executando uma compilação local.