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)