Korea Weather MCP Server

Korea Weather MCP Server

本 MCP サーバーは、気象庁の短期予報照会サービス APIを基に動作する MCP サーバーです。

紹介

Korea Weather MCP Serverは、気象庁の気象情報を収集し、MCP プロトコルを通じて Claude や Cursor などの MCP クライアント（ホスト）に提供します。 このサーバーは、気象情報を活用するさまざまなアプリケーションサービスと簡単に連携できます。

主な機能

• 気象庁の短期予報 API との連携
• MCP 形式での気象情報の提供

インストールと使用方法

Smithery を利用したインストール

1. data.go.krで気象庁の短期予報 APIを申請し、API キーを発行します。
2. 次のコマンドを使用して、Smitheryからサーバーをインストールし、Claude Desktop に登録します。 インストール中に API キーの入力を求められた場合は、発行済みのキーを入力します。

   npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude
   

3. Claude Desktop を再起動して使用します。

ローカル開発（Smithery CLI）

1. ソースコードをクローンし、依存関係をインストールします。

   git clone https://github.com/ohhan777/korea_weather.git
   cd korea_weather
   uv sync
   

2. 環境変数に API キーを設定します。

   export KOREA_WEATHER_API_KEY="발급받은_API_키"
   

3. 開発サーバーを起動します。

   # HTTP 모드로 실행 (http://localhost:8081)
   uv run smithery dev
   
   # 또는 Smithery Playground로 대화형 테스트
   uv run smithery playground
   

GitHub から直接インストールする方法

1. data.go.krで気象庁の短期予報 API の利用を申請し、API キーを発行します。

2. githubからソースコードをダウンロードして実行します。

   git clone https://github.com/ohhan777/korea_weather.git
   cd korea_weather
   uv sync
   uv run korea_weather.py
   

3. MCP クライアント（ホスト）にサーバーを登録します。

   • Claude Desktopの設定ファイルは通常、以下の場所にあります。 C:\Users\[사용자 이름]\AppData\Roaming\Claude\claude_desktop_config.json （ファイルがない場合は新しく作成）

   • Cursorの場合：上部の歯車アイコン → MCP → Add new global MCP serverを選択

   以下の例のような形式で設定ファイルを作成します。（ディレクトリのパスと API キーは環境に合わせて変更してください）

   {
     "mcpServers": {
       "korea_weather": {
         "command": "uv",
         "args": [
           "--directory",
           "C:\\ai\\PyProjects\\korea_weather",
           "run",
           "korea_weather.py"
         ],
         "env": {
           "KOREA_WEATHER_API_KEY": "Input Your API Key Here!"
         }
       }
     }
   }
   

Smithery へのデプロイ

GitHub にコードをプッシュした後、smithery.ai/newで GitHub リポジトリを接続すると、Smithery がサーバーを自動的にビルドしてホスティングします。

プロンプトの例

>> 제주 국제 공항 현재 날씨를 알려줘.
>> 내일 오후에 서울 남대문에 놀러가려고 하는데 우산을 챙겨야할까?
>> 오늘 오후에 세차하기에 괜찮은 날씨일까?

依存関係

pyproject.tomlを参照してください

ライセンス

本プロジェクトは内部試験用に開発されており、個別のライセンス規定はなく、自由に配布および変更できます。

お問い合わせ

開発者：韓国航空宇宙研究院 オ・ハン（[email protected]）

更新履歴

• 2026-02：Smithery v4 との連携 — smithery dev/smithery playgroundによるローカル開発に対応し、create_server()ファクトリーパターンを導入
• 2026-02：サーバー構造をリファクタリングし（共通 API リクエスト処理、座標変換キャッシュ）、MCP ツールの説明を拡充しました。
• 2026-02：httpx/dotenvがインストールされていない環境でも動作するよう、標準ライブラリを基にした HTTP フォールバック経路を追加しました。
• 2026-02：オフライン環境でも実行できる単体テスト（tests/test_korea_weather.py）を追加しました。