Korea Weather MCP Server

Korea Weather MCP Server

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

简介

Korea Weather MCP Server 收集气象厅的天气信息，并通过 MCP 协议将其提供给 Claude、Cursor 等 MCP 客户端（Host）。 该服务可以轻松集成到各类使用气象信息的应用服务中。

主要功能

• 集成气象厅短期预报 API
• 以 MCP 格式提供气象信息

安装和使用方法

使用 Smithery 安装

1. 在 data.go.kr 申请气象厅短期预报 API，并获取 API 密钥。
2. 使用以下命令从 Smithery 安装服务，并将其添加到 Claude Desktop。 如果安装过程中要求输入 API 密钥，请输入已获取的密钥。

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

3. 重启 Claude Desktop 即可使用。

本地开发（Smithery CLI）

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

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

2. 在环境变量中设置 API 密钥。

   export KOREA_WEATHER_API_KEY="발급받은_API_키"
   

3. 启动开发服务。

   # HTTP 모드로 실행 (http://localhost:8081)
   uv run smithery dev
   
   # 또는 Smithery Playground로 대화형 테스트
   uv run smithery playground
   

从 GitHub 直接安装

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

2. 从 github 下载源代码并尝试运行。

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

3. 在 MCP 客户端（Host）中注册服务。

   • Claude Desktop 的配置文件通常位于以下路径。 C:\Users\[사용자 이름]\AppData\Roaming\Claude\claude_desktop_config.json （如果文件不存在，请新建）

   • Cursor：选择顶部的齿轮图标 → MCP → Add new global MCP server

   按照以下示例格式编写配置文件。（根据实际环境修改目录路径和 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 后，在 smithery.ai/new 连接 GitHub 仓库，Smithery 就会自动构建并托管服务。

提示词示例

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

依赖项

请参阅 pyproject.toml

许可证

本项目为内部测试而开发，可在不受单独许可条款限制的情况下自由分发和修改。

联系方式

开发者：韩国航空宇宙研究院 Oh Han（[email protected]）

修改历史

• 2026-02：集成 Smithery v4 — 支持通过 smithery dev/smithery playground 进行本地开发，引入 create_server() 工厂模式
• 2026-02：重构服务结构（通用 API 请求处理、坐标转换缓存），并完善 MCP 工具说明。
• 2026-02：新增基于标准库的 HTTP fallback 路径，使其在未安装 httpx/dotenv 的环境中也能运行。
• 2026-02：新增可在离线环境中运行的单元测试（tests/test_korea_weather.py）。