山火事情報の可視化MCPサーバー

はじめに

このプロジェクトは、火災発生データを収集、分析し、地図に視覚化するPythonベースのMCPサーバーです。ユーザーは、地域別の山火事発生情報、危険度分析、地図の視覚化など、さまざまな機能を利用できます。

Related MCP server: Ordnance Survey MCP Server

フォルダ構造

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がインストールされていない場合は、次の手順に従ってインストールしてください。

Python公式ウェブサイトにアクセスしてください。
ページ上部の黄色いボタン「Download Python XXX」をクリックして最新バージョンをダウンロードします。
ダウンロードしたインストーラを実行します。
インストール画面の最も重要な部分は**、「Add Python.exe to PATH」**オプションです。
- このオプションを必ずチェックしてください！（画面下部のチェックボックス）
- この設定により、コマンドプロンプトでPythonを実行できます。
「Install Now」をクリックしてインストールを続行します。
インストールが完了したら、[閉じる]ボタンをクリックします。

Pythonのインストールを確認する

キーボードのWindows 키 + Rを押します。
[実行]ウィンドウにcmdと入力し、[OK]をクリックします。
開いたコマンドプロンプトウィンドウに次のコマンドを入力し、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년 산불 데이터를 알려줘

山火事リスク分析:

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

地図で確認:

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

Forest Fire Visualization MCP Server