산불 정보 시각화 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 설치하기
파이썬이 설치되어 있지 않은 경우 다음 단계를 따라 설치하세요:
- 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년 산불 데이터를 알려줘 - 산불 위험도 분석:
강원도 고성 지역의 산불 위험도는 어떻게 되나요? - 지도에서 확인:
강원도 고성의 산불 위치를 지도에서 보여줘