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-지진-MCP

USGS Quakes API를 위한 Claude MCP 서버

Claude Desktop 내에서 USGS Quakes API 에 대한 액세스를 제공하기 위한 MCP 서버 구현입니다.

개요

이 모델 컨텍스트 프로토콜(MCP) 서버를 통해 AI 어시스턴트와 애플리케이션은 다음을 수행할 수 있습니다.

  • 다양한 검색 매개변수를 통해 지진 데이터를 얻으세요
  • 특정 지진에 대한 세부 정보를 얻으세요

사용자는 자연어를 사용하여 쿼리를 실행할 수 있습니다.

샘플 출력

질문: 지난 20년 동안 플로리다에서 발생한 규모 2 이상의 지진을 찾으세요.

답변: 지난 20년 동안 플로리다에서 발생한 규모 2.0 이상의 지진을 검색하는 데 도움을 드리겠습니다.

usgs-quakes(로컬)에서 find-earthquakes의 결과 보기

지엑스피1

USGS 지진 데이터에 따르면, 지난 20년 동안 플로리다 또는 그 주변에서 주목할 만한 지진이 3번 발생했습니다.

  1. 2006년 9월 10일 멕시코만에서 발생한 규모 5.9의 지진은 북위 26.319도, 서경 86.606도에서 발생했으며 깊이는 14km였습니다. 이 지진은 이 기간 동안 이 지역에서 발생한 가장 큰 지진이었습니다. 5,763명이 지진을 느꼈다고 보고했으며 널리 감지되었습니다.
  2. 2019년 3월 6일 플로리다 주 제이 근처에서 발생한 규모 2.8 지진(위치: 북위 30.9718°, 서경 87.1719°) 깊이: 5km 49명이 이 지진을 느꼈다고 보고했습니다.
  3. 2019년 3월 24일 플로리다 센추리 인근에서 발생한 규모 2.7 지진(위도 30.9622°N, 서경 87.2384°) 깊이 5km 지진을 느꼈다고 보고한 사람은 4명

플로리다는 미국에서 지진 활동이 활발한 지역에 비해 지진 발생 빈도가 상대적으로 낮다는 점에 주목할 필요가 있습니다. 2019년에 발생한 두 건의 지진은 플로리다 팬핸들에서 발생했고, 2006년에 발생한 더 큰 지진은 멕시코만 연안에서 발생했습니다.

질문: 플로리다 제이 지진에 대한 자세한 내용을 알아보세요

A: 플로리다 주 제이 근처에서 발생한 규모 2.8의 지진에 대한 자세한 정보를 알아보겠습니다.

usgs-quakes(로컬)의 find-earthquake-details에서 결과 보기

{ "eventid": "us1000jbw4" }

플로리다 주 제이 지진에 대한 주요 세부 정보는 다음과 같습니다. 날짜 및 시간: 2019년 3월 7일 04:45:52 UTC 위치: 플로리다 주 제이 북서쪽 2km(1.2마일) 좌표: 북위 30.9718°, 서경 87.1719° 깊이: 5km(3.1마일) 규모: 2.8 mb_lg(실체파 규모)

추가 세부 정보:

  • 49명이 지진을 느꼈다고 보고했다
  • CIIM(Community Internet Intensity Map)은 최대 강도가 2.7임을 보여주었습니다.
  • 쓰나미가 발생하지 않았습니다
  • 지진은 USGS 과학자들에 의해 검토 및 확인되었습니다.
  • 해당 위치의 수평 오차 한계는 약 6.2km였습니다.
  • 규모 계산에는 11개 지진 관측소의 데이터가 사용되었습니다.
  • 뉴멕시코 지진 관측망(NM)에서도 지진을 감지했으며, 규모는 약간 다른 2.63으로 계산되었습니다.

기술적 측정:

  • 방위각 차이: 243도(지진 관측소의 중간 범위임을 나타냄)
  • RMS 오차: 0.59(위치 추정의 품질이 적절함을 나타냄)
  • 가장 가까운 역까지의 최소 거리: 0.222도
  • 크기에 대한 표준 오차: 0.154

비교적 약한 지진이었지만, 지진 활동이 거의 없는 플로리다에서는 주목할 만한 지진이었습니다. 49명이 진동을 느꼈다는 사실은 인근 지역 주민들이 진동을 느낄 수 있었음을 시사하지만, 이 정도 규모의 지진이 발생하더라도 큰 피해는 예상되지 않습니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 USGS 지진 데이터를 자동으로 설치하려면:

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

수동 설치

Node.js와 MCP 프로토콜에 익숙하지 않다면 설치하는 것이 까다로울 수 있습니다.

  1. Node.js 설치
  2. 이 저장소를 로컬 컴퓨터의 폴더에 복제하세요.
  3. 서버가 이미 구축되어 있으므로 빌드 단계를 건너뛸 수 있습니다.

추가 단계

서버를 변경하려면 src/index.ts 파일을 편집하면 됩니다.

  • npm install 실행하여 종속성을 설치합니다.
  • npm run build 실행하여 서버를 빌드합니다.
  • 변경 사항을 적용한 후 Claude Desktop을 종료하고 다시 시작하세요.

Claude Desktop과 연결

  1. Claude Desktop 구성을 다음에서 엽니다.
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. 서버 구성을 추가합니다.
{ "mcpServers": { "usgs-quakes": { "command": "node", "args": [ "/Full/Route/to/Folder/usgs-quakes/build/index.js" ] } } }
  1. Claude Desktop을 닫거나 종료한 후 다시 시작하세요.

재시작하면 텍스트 상자 오른쪽 하단에 작은 망치 아이콘이 표시됩니다. 아이콘 위에 마우스를 올리면 사용 가능한 MCP 도구의 개수가 표시됩니다.

문제 해결

서버 실행 중 오류가 발생하면 node 명령어의 전체 경로를 입력해야 할 수 있습니다. 예를 들어 macOS에서는 /usr/local/bin/node 입력합니다.

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

Claude Desktop 내에서 USGS Quakes API에 대한 액세스를 제공하여 사용자가 자연어 쿼리를 통해 지진 데이터와 세부 정보를 검색할 수 있도록 합니다.

  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