산불 정보 시각화 MCP 서버

Name: Forest Fire Visualization MCP Server
Availability: InStock
Author: LangDB

소개

이 프로젝트는 산불 발생 데이터를 수집, 분석하고 지도에 시각화하는 Python 기반 MCP 서버입니다. 사용자는 지역별 산불 발생 정보, 위험도 분석, 지도 시각화 등 다양한 기능을 이용할 수 있습니다.

폴더 구조

MCP/
├── README.md                    # 프로젝트 설명 문서
├── forest_fire_mcp_server.py    # MCP 서버 메인 파일
├── forest_fire_data.py          # 데이터 처리 모듈
├── forest_fire_data.json        # 산불 데이터 파일
├── claude_desktop_config.json   # Claude 설정 파일
├── data/                        # 산불 데이터 저장 폴더
└── venv/                        # 가상환경 폴더(필요 시)

설치 요구사항

Python 설치하기

파이썬이 설치되어 있지 않은 경우 다음 단계를 따라 설치하세요:

Python 공식 웹사이트에 접속합니다.
페이지 상단의 노란색 버튼 "Download Python X.X.X"를 클릭하여 최신 버전을 다운로드합니다.
다운로드된 설치 프로그램을 실행합니다.
설치 화면에서 가장 중요한 부분은 "Add Python.exe to PATH" 옵션입니다.
- 이 옵션을 반드시 체크해주세요! (화면 하단의 체크박스)
- 이 설정은 명령 프롬프트에서 Python을 실행할 수 있게 해줍니다.
"Install Now"를 클릭하여 설치를 진행합니다.
설치가 완료되면 "Close" 버튼을 클릭합니다.

Python 설치 확인하기

키보드의 Windows 키 + R을 누릅니다.
실행 창에 cmd를 입력하고 확인을 클릭합니다.
열린 명령 프롬프트 창에 다음 명령어를 입력하고 Enter를 누릅니다:
```
python --version
```
Python 버전이 표시되면 설치가 성공적으로 완료된 것입니다. 예시: Python 3.12.0

필요한 패키지 설치하기

Python이 설치되었다면, 필요한 패키지들을 설치해야 합니다:

Cursor AI 메뉴 터미널에서 New Terminal을 클릭합니다.
다음 명령어를 입력하고 Enter를 누릅니다:
```
pip install mcp httpx requests
```
설치가 진행되는 동안 기다립니다.
만약 오류가 발생하면, 다음 명령어를 대신 시도해보세요:
```
pip install --user mcp httpx requests
```

Python 인터프리터 설정하기

만약 패키지 설치 후에도 오류가 발생한다면, Python 인터프리터 설정을 확인해보세요:

Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
"Python: Select Interpreter" 입력 후 선택합니다.
가상환경 인터프리터를 선택합니다:
- ./venv/Scripts/python.exe

프로젝트 파일 설정하기

프로젝트 파일 준비

이 저장소의 모든 파일을 컴퓨터의 원하는 위치에 다운로드합니다.
예: C:\Users\사용자이름\Desktop\MCP 폴더 생성 후 파일 복사

데이터 파일 확인

forest_fire_data.json 파일이 폴더 안에 있는지 확인합니다.
이 파일은 산불 데이터를 포함하고 있는 중요한 파일입니다.

서버 설정 파일 수정

forest_fire_mcp_server.py 파일을 메모장으로 엽니다.
FOREST_FIRE_DATA_PATH 변수를 찾아 실제 경로로 수정합니다:


# 예시:
FOREST_FIRE_DATA_PATH = "C:/Users/사용자이름/Desktop/MCP/forest_fire_data.json"

파일을 저장하고 닫습니다.

서버 실행하기

실행 방법 1: 코드 옆 실행 버튼 사용

forest_fire_mcp_server.py 파일을 엽니다.
파일 내용 왼쪽에 표시되는 ▶️ (실행) 버튼을 클릭합니다.
- Cursor AI가 자동으로 Python 스크립트를 실행합니다.
- 별도의 명령어 입력이 필요 없습니다.

실행 방법 2: 터미널에서 직접 실행

Cursor AI 메뉴 터미널에서 New Terminal을 클릭합니다.
다음 명령어를 입력하고 Enter를 누릅니다:
```
python forest_fire_mcp_server.py
```

서버 실행 확인

다음과 같은 메시지가 표시되면 성공:

산불정보 시각화 MCP 서버가 시작되었습니다.

이 터미널을 닫지 마세요! 서버가 실행 중인 상태를 유지해야 합니다.

Claude 데스크톱 앱 설정하기

Claude 데스크톱 앱 설치

Claude 데스크톱 앱 다운로드 페이지에서 설치 파일을 다운로드합니다.
다운로드된 설치 파일을 실행합니다.
설치 마법사의 지시를 따라 설치를 완료합니다.

Claude MCP 설정하기

Claude 앱을 실행합니다.
우측 상단의 파일 메뉴에서 설정(⚙️) 아이콘을 클릭합니다.
왼쪽 메뉴에서 '개발자' 탭을 선택합니다.
'설정 편집'을 클릭하여 C:/Users/사용자이름/Desktop/MCP/claude_desktop_config.json 파일을 지정합니다.

Claude 데스크톱 앱 재시작

Claude 데스크톱 앱을 완전히 종료했다가 다시 실행합니다.
우측 상단에 망치 🔨 아이콘이 표시되면 MCP 서버와 연결이 성공한 것입니다.
- 망치 아이콘이 회색이면 MCP 서버가 실행되지 않은 상태입니다.
- 망치 아이콘이 파란색이면 MCP 서버가 정상적으로 연결된 상태입니다.

주요 기능 사용하기

Claude 앱에서 다음과 같은 명령어를 입력하여 서버의 기능을 사용할 수 있습니다:

산불 데이터 조회:

강원도의 2021년 산불 데이터를 알려줘

산불 위험도 분석:

강원도 고성 지역의 산불 위험도는 어떻게 되나요?

지도에서 확인:

강원도 고성의 산불 위치를 지도에서 보여줘

Related MCP Server Resources

Forest Fire Visualization MCP Server

Supercharge Your AI with Forest Fire Visualization MCP Server