GeoTap MCP 서버

Claude, Cursor, Windsurf 및 기타 AI 도구를 80개 이상의 미국 연방 환경 및 인프라 데이터 소스에 연결하세요.

GeoTap은 FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, 인구조사국 등에서 데이터를 집계하며, MCP(Model Context Protocol)를 통해 액세스할 수 있습니다.

웹 앱: geotapdata.com — 코딩 없이 지도에 그림을 그려 데이터를 시각적으로 탐색할 수 있습니다.

시작하기

사전 요구 사항

• Node.js (v18 이상) — 여기서 다운로드

• API 키 등록을 위한 이메일 주소

1단계: API 키 받기

**geotapdata.com/developers**에 접속하여 이메일로 등록하고 무료 API 키를 받으세요.

API 키가 이메일로 전송됩니다. 저장해 두세요 — 다음 단계에서 필요합니다.

2단계: MCP 서버 설정

아래에서 사용하는 AI 도구를 선택하고 지침을 따르세요. MCP 서버는 npx를 통해 자동으로 설치되므로 수동 다운로드가 필요하지 않습니다.

1. Claude Desktop을 엽니다.

2. 설정(톱니바퀴 아이콘) → 개발자 → 설정 편집으로 이동합니다.

3. claude_desktop_config.json 파일이 열립니다. 다음 내용을 추가하세요 (your-api-key-here를 실제 키로 교체):

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

4. Claude Desktop을 완전히 재시작(종료 후 다시 열기)합니다.

5. 채팅 입력창에 망치 아이콘(🔨)이 보이면 GeoTap이 연결된 것입니다.

다음 명령어를 실행하여 Claude Code MCP 서버에 GeoTap을 추가하세요:

claude mcp add geotap -- npx -y geotap-mcp-server

그런 다음 API 키를 환경 변수로 설정합니다. 셸 프로필(~/.zshrc, ~/.bashrc 등)에 다음을 추가하세요:

export GEOTAP_API_KEY="your-api-key-here"

터미널을 재시작한 후 Claude Code를 시작하세요. GeoTap 도구를 자동으로 사용할 수 있습니다.

1. Cursor를 엽니다.

2. 설정(Mac은 ⌘ + ,, Windows는 Ctrl + ,) → **"MCP"**를 검색합니다.

3. **"Edit in settings.json"**을 클릭하거나 .cursor/mcp.json 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Cursor를 재시작합니다.

5. AI 채팅 패널을 열면 사용 가능한 도구 목록에 GeoTap 도구가 나타납니다.

1. Windsurf를 엽니다.

2. 설정 → MCP Servers로 이동합니다 (또는 ~/.codeium/windsurf/mcp_config.json을 직접 편집).

3. 다음을 추가합니다:

{
  "mcpServers": {
    "geotap": {
      "command": "npx",
      "args": ["-y", "geotap-mcp-server"],
      "env": {
        "GEOTAP_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Windsurf를 재시작합니다.

모든 MCP 클라이언트에서 서버를 직접 실행할 수 있습니다:

# Install globally
npm install -g geotap-mcp-server

# Run with your API key
GEOTAP_API_KEY=your-api-key-here geotap-mcp

서버는 stdio를 통해 통신합니다. MCP 클라이언트에서 GEOTAP_API_KEY 환경 변수를 설정한 상태로 geotap-mcp 명령어를 가리키도록 하세요.

3단계: 질문 시작하기

연결이 완료되면 AI 어시스턴트에게 미국 내 모든 지역에 대한 데이터를 요청하세요. GeoTap은 80개 이상의 연방 소스에서 데이터를 한 번에 수집합니다. 위치를 알려주고 원하는 내용을 질문하세요:

"Collect site data for 123 Main St, Austin TX"

데이터가 반환되면(~60-120초 소요), 다음과 같은 후속 질문을 할 수 있습니다:

• "이 부지가 홍수 구역에 포함되나요?"

• "이곳의 토양 유형은 무엇이며 곡선 번호(curve number)는 얼마인가요?"

• "근처에 오염 우려 사항이 있나요?"

• "100년 빈도 강우량은 얼마인가요?"

• "이 부지를 개발하려면 어떤 허가가 필요한가요?"

• "주요 환경 위험 요소를 요약해 주세요"

문제 해결

데이터 소스

모든 응답에는 출처가 포함되어 있습니다 (연방 기관, 데이터셋 이름, 참조 URL).

설정

활용 사례

토목 및 환경 공학

• 우수 설계: 강우량(Atlas 14, IDF 곡선, 우량주상도), 곡선 번호, 집중 시간, 최대 유출량

• 홍수 분석: Bulletin 17C 홍수 빈도, 유량 지속 시간 곡선, 지역 회귀 추정치

• 유역 구분 및 수문 모델링 입력 데이터(HEC-HMS, SWMM)

• NPDES 허가를 위한 저유량 분석(7Q10, 7Q2, 조화 평균 유량)

• 인프라 복원력을 위한 기후 조정 설계 폭풍

부동산 및 개발

• 부동산 거래를 위한 환경 실사

• 부지 타당성 및 개발 가능성 점수 산정 (0-100점)

• 홍수 구역, 습지 및 오염 심사

• 허가 경로 분석 (섹션 404, NPDES, 홍수터 개발)

환경 컨설팅

• 1단계 환경 현장 조사(ESA) 데스크톱 데이터 수집 (EPA 부지, 수질)

• 습지 구분 지원 (NWI + 토양 + 수문)

• 멸종 위기 종 서식지 심사 (USFWS 핵심 서식지)

• 수질 악화 평가 (EPA ATTAINS 303(d) 목록)

기여

기여를 환영합니다! 이슈를 열거나 풀 리퀘스트를 보내주세요.

라이선스

MIT

링크

• 웹 앱: geotapdata.com

• 이슈: GitHub Issues

• npm: geotap-mcp-server