JinDaGe - korea_weather MCP Details

article

README

🚀 韩国天气 MCP 服务器

本 MCP 服务器基于韩国气象厅短期预报信息服务 API 运行，能够收集韩国气象信息，并通过 MCP 协议为 Claude 或 Cursor 等 MCP 客户端（宿主）提供服务，可轻松应用于各类需要天气信息的应用程序服务中。

🚀 快速开始

本服务器可通过 Smithery 简便安装，也能通过 GitHub 手动安装。安装前需先访问 data.go.kr 申请 韩国气象厅短期预报 API 并获取 API 密钥。

通过 Smithery 的简便安装

访问 data.go.kr 申请 API 密钥。
使用以下命令在 Smithery 安装服务器并在 Claude Desktop 中注册：在安装过程中，若提示输入 API 密钥，请输入之前获取的密钥。

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

重启 Claude Desktop 即可使用。

通过 GitHub 手动安装

访问 data.go.kr 申请 API 密钥。
在 github 下载源代码并运行：

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

将服务器添加到 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)

MCP 示例

korea_weather