산불 정보 시각화 MCP 서버

소개

이 프로젝트는 산불 발생 데이터를 수집, 분석하고 지도에 시각화하는 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 설치하기

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

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

---

Python 설치 확인하기

1. 키보드의 Windows 키 + R을 누릅니다.
2. 실행 창에 cmd를 입력하고 확인을 클릭합니다.
3. 열린 명령 프롬프트 창에 다음 명령어를 입력하고 Enter를 누릅니다:

   python --version
   

4. Python 버전이 표시되면 설치가 성공적으로 완료된 것입니다. 예시: Python 3.12.0

---

필요한 패키지 설치하기

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

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

   pip install mcp httpx requests
   

3. 설치가 진행되는 동안 기다립니다.
4. 만약 오류가 발생하면, 다음 명령어를 대신 시도해보세요:

   pip install --user mcp httpx requests
   

---

Python 인터프리터 설정하기

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

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

---

프로젝트 파일 설정하기

프로젝트 파일 준비

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

데이터 파일 확인

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

서버 설정 파일 수정

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

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

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

---

서버 실행하기

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

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

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

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

   python forest_fire_mcp_server.py
   

서버 실행 확인

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

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

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

---

Claude 데스크톱 앱 설정하기

Claude 데스크톱 앱 설치

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

Claude MCP 설정하기

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

Claude 데스크톱 앱 재시작

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

---

주요 기능 사용하기

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

1. 산불 데이터 조회:

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

2. 산불 위험도 분석:

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

3. 지도에서 확인:

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

---

추가 정보

카카오맵 API 키: 기본적으로 설정되어 있으므로 수정할 필요가 없습니다.

지도 시각화: 자동으로 웹 브라우저에서 열립니다.