Forest Fire Visualization MCP Server

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

はじめに

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

フォルダ構造

設置要件

Pythonのインストール

Pythonがインストールされていない場合は、次の手順に従ってインストールしてください。

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

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

1. キーボードのWindows 키 + Rを押します。
2. [実行]ウィンドウにcmdと入力し、[OK]をクリックします。
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変数を見つけて実際のパスに変更します。

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. 次のメッセージが表示された場合は成功します。

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キー：デフォルトで設定されているため、変更する必要はありません。

地図の視覚化：自動的にWebブラウザで開きます。