韩国天气 MCP 服务器

本 MCP 服务器基于 韩国气象厅短期预报信息服务 API 运行。

简介

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 install @ohhan777/korea_weather --client claude
   

3. 重启 Claude Desktop 即可使用。

通过 GitHub 手动安装

1. 访问 data.go.kr 申请韩国气象厅短期预报 API 并获取 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 密钥！"
         }
       }
     }
   }
   

提示示例

>> 请告诉我济州国际机场当前的天气情况。
>> 我计划下午去首尔南大门游玩，需要带伞吗？
>> 今天下午洗车合适吗？

依赖项

参考 pyproject.toml 文件。

许可证

本项目为内部测试用途开发，无额外许可规定，可自由分发和修改。

联系方式

开发者：韩国航空宇宙研究院 柳韩 (ohhan@kari.re.kr)