Korea Weather

🚀 韓國天氣 MCP 服務器

本 MCP 服務器基於韓國氣象廳短期預報信息服務 API 運行，能夠收集韓國氣象信息，並通過 MCP 協議為 Claude 或 Cursor 等 MCP 客戶端（宿主）提供服務，可輕鬆應用於各類需要天氣信息的應用程序服務中。

🚀 快速開始

本服務器可通過 Smithery 簡便安裝，也能通過 GitHub 手動安裝。安裝前需先訪問 data.go.kr 申請 韓國氣象廳短期預報 API 並獲取 API 密鑰。

通過 Smithery 的簡便安裝

1. 訪問 data.go.kr 申請 API 密鑰。
2. 使用以下命令在 Smithery 安裝服務器並在 Claude Desktop 中註冊： 在安裝過程中，若提示輸入 API 密鑰，請輸入之前獲取的密鑰。

npx -y @smithery/cli install @ohhan777/korea_weather --client claude

3. 重啟 Claude Desktop 即可使用。

通過 GitHub 手動安裝

1. 訪問 data.go.kr 申請 API 密鑰。
2. 在 github 下載源代碼並運行：

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

3. 將服務器添加到 MCP 客戶端（宿主）中：
   • 對於 Claude Desktop，配置文件通常位於： C:\Users\[用戶名]\AppData\Roaming\Claude\claude_desktop_config.json
     （若文件不存在，則會自動創建）
   • 對於 Cursor：選擇頂部齒輪圖標（⚙️）→ MCP → 添加新的全局 MCP 服務器

按照以下示例格式編輯配置文件（根據實際情況調整目錄路徑和 API 密鑰）：

{
    "mcpServers": {
        "korea_weather": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ai\\PyProjects\\korea_weather",  
                "run",
                "korea_weather.py"
            ],
            "env": {
                "KOREA_WEATHER_API_KEY": "請輸入您的 API 密鑰！"
            }
        }
    }
}

✨ 主要特性

• 集成韓國氣象廳短期預報 API
• 提供 MCP 格式的氣象信息

💻 使用示例

提示示例

>> 請告訴我濟州國際機場當前的天氣情況。
>> 我計劃下午去首爾南大門遊玩，需要帶傘嗎？
>> 今天下午洗車合適嗎？

📚 詳細文檔

依賴項

參考 pyproject.toml 文件。

許可證

本項目為內部測試用途開發，無額外許可規定，可自由分發和修改。

聯繫方式

開發者：韓國航空宇宙研究院 柳韓 (ohhan@kari.re.kr)