AI导哈

韩国天气MCP服务器

基于韩国气象厅短期预报API，通过MCP协议向客户端提供天气信息的服务器，适用于需要集成天气数据的应用服务。

  • by ohhan777
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 ohhan777/korea_weather

使用说明

韩国气象MCP服务器

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

介绍

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

主要功能

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

安装和使用方法

使用Smithery安装

  1. data.go.kr在 气象厅短期预报API申请并获得API密钥。
  2. 使用以下命令 史密瑟里在中安装服务器并在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）中注册服务器。

    • 克劳德桌面的设置文件通常位于以下路径中： 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）。

相关 MCP