Forest Fire Visualization MCP Server

# 산불 정보 시각화 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 공식 웹사이트](https://www.python.org/downloads/)에 접속합니다. 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` 변수를 찾아 실제 경로로 수정합니다: ```python # 예시: 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 데스크톱 앱 다운로드 페이지](https://claude.ai/desktop)에서 설치 파일을 다운로드합니다. 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 키**: 기본적으로 설정되어 있으므로 수정할 필요가 없습니다. ### **지도 시각화**: 자동으로 웹 브라우저에서 열립니다.