Korea Weather MCP Server

韩国气象MCP服务器

](https://smithery.ai/server/@ohhan777/korea_weather)

本MCP服务器 气象厅短期预报查询服务API基于的MCP服务器。

介绍

韩国气象MCP服务器收集气象局的天气信息，通过MCP协议提供给MCP客户端（主机），如Claude或Cursor。 该服务器可以轻松地与利用气象信息的各种应用服务配合使用。

MCP Example

主要功能

• 气象厅短期预报API联动
• 提供MCP格式的天气信息

安装和使用方法

使用Smithery安装

1. data.go.kr在 气象厅短期预报API申请并获得API密钥。
2. 使用以下命令 史密瑟里在中安装服务器并在Claude Desktop中注册。

如果在安装过程中要求输入API密钥，请输入已颁发的密钥。

   npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude

1. 重新启动Claude Desktop即可使用。

本地开发（Smithery CLI）

1. 克隆源代码并安装依赖性。

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

1. 为环境变量设置API密钥。

   export KOREA_WEATHER_API_KEY="발급받은_API_키"

1. 运行开发服务器。

   # HTTP 모드로 실행 (http://localhost:8081)
   uv run smithery dev

   # 또는 Smithery Playground로 대화형 테스트
   uv run smithery playground

如何直接从GitHub安装

1. data.go.kr在申请气象厅短期预报API使用后，将获得API密钥。

1. 下载并运行源代码。

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

1. 在MCP客户机（Host）中注册服务器。

- 克劳德桌面的设置文件通常位于以下路径中： C:\Users\[사용자 이름]\AppData\Roaming\Claude\claude_desktop_config.json （如果文件不存在，则创建新文件）

- 光标在中：顶部的齿轮图标→ MCP → 添加新的全局MCP服务器 选择

以以下示例中的格式创建配置文件。（根据环境修改目录路径和API密钥）

   {
     "mcpServers": {
       "korea_weather": {
         "command": "uv",
         "args": [
           "--directory",
           "C:\\ai\\PyProjects\\korea_weather",
           "run",
           "korea_weather.py"
         ],
         "env": {
           "KOREA_WEATHER_API_KEY": "Input Your API Key Here!"
         }
       }
     }
   }

部署到Smithery

将代码推送到GitHub后， 史密斯·艾/新连接GitHub存储库后，Smithery将自动构建和托管服务器。

提示示例

>> 제주 국제 공항 현재 날씨를 알려줘.
>> 내일 오후에 서울 남대문에 놀러가려고 하는데 우산을 챙겨야할까?
>> 오늘 오후에 세차하기에 괜찮은 날씨일까?

依赖性

pyproject.toml 请参见

许可证

本项目是为内部试验而开发的，无需另行许可，即可自由部署和修改。

咨询

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

修改历史记录

• 2026-02:Smithery v4集成- smithery dev/smithery playground 本地开发支持， create_server() 引入工厂模式
• 2026-02:重新设计服务器结构（通用API请求处理、坐标转换缓存），增强MCP工具提示。
• 2026-02: httpx/dotenv 我们添加了一个基于标准库的HTTP回退路径，以在未安装的环境中运行。
• 2026-02:在离线环境中运行的单元测试（tests/test_korea_weather.py）。