韩国天气MCP服务器

本MCP服务器基于气象局短期预报查询服务API运行。

简介

韩国天气MCP服务器收集气象局的天气信息，并通过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)