Python MCP 韩国气象局

这是使用 MCP（模型控制协议）服务器的韩国气象信息服务。

如何安装

克隆此存储库：

git clone https://github.com/jikime/py-mcp-ko-weather.git
cd py-mcp-ko-weather

紫外线安装

curl -LsSf https://astral.sh/uv/install.sh | sh

使用 uv 创建虚拟环境并安装必要的软件包：

uv venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txt

在您的 .env 文件中设置您的 Met Office API 密钥：

cp env.example .env
vi .env
KO_WEATHER_API_KEY=your_api_key_here

将数据从 Excel 中的天气网格坐标迁移到 SQLite。

uv run src/migrate.py

如何颁发气象局 API 密钥

进入公共数据门户，注册成为会员，并登录。
检索并申请使用“韩国气象局_短期预报（旧）_邻近预报）查询服务”API。
批准后，在.env文件中设置收到的API密钥。

配置 MCP 工具

打开 ~/Library/Application\ Support/Claude/claude_desktop_config.json 文件并添加天气服务器。

{
    "mcpServers": {
      "Korea Weather": {
        "command": "/Users/jikime/Dev/.local/bin/uv",
        "args": [
          "--directory",
          "/Users/jikime/Dev/py-mcp-ko-weather",
          "run",
          "src/server.py"
        ]
      }
    }
}

如何运行

启动 Claude Desktop 以确保它已添加到您的工具中。
尝试输入“首尔市瑞草区良才一洞的天气怎么样？”在聊天输入框中。

功能描述

该 MCP 服务器提供以下功能：

工具

获取位置坐标（ get_grid_location ）
- 描述：检索韩国气象局 API 中使用的网格坐标 (nx, ny)。根据用户输入的城市/道、区/县、镇/村信息，从数据库中搜索并返回相应区域的韩国气象局网格坐标。此工具对于获取气象局 API 调用所需的精确坐标至关重要。
- 参数：
  - city ：城市/省份名称（例如“首尔”）
  - gu : 地区/县名（例如“瑞草区”）
  - dong ：洞/镇/村庄的名称（例如“Yangjae 1-dong”）
- 数据是从嵌入式 SQLite 数据库 ( data/weather_grid.db ) 检索的。
获取天气预报（ get_forecast ）
- 描述：通过调用韩国气象局的短期预报API，提供特定区域的天气预报信息。根据用户输入的位置信息和网格坐标检索当前天气信息。该工具包含温度、降水、天空状况、湿度、风向和风速等详细天气信息，并提供长达 6 小时的短期预报。
- 参数：
  - city ：城市/省份名称（例如“首尔”）
  - gu : 地区/县名（例如“瑞草区”）
  - dong ：洞/镇/村名称（例如“Yangjae 1-dong”）
  - nx ：X网格坐标
  - ny ：Y 网格坐标

资源

天气服务用户手册（ weather-instructions ）

URI： weather-instructions
描述：详细解释如何使用韩国气象局的指南。该资源提供使用该服务所需的所有信息，包括如何使用该工具、工作流程和响应格式。 LLM 包含结构化信息，使学生能够有效地利用天气工具。

提示

天气信息查询提示（ weather-query ）

描述：查询韩国地区天气信息的交互式提示模板。这些提示引导用户和 LLM 之间的结构化对话，建议适当的工具使用顺序和响应格式。它涵盖了如何从用户那里收集必要的信息并提供清晰的天气预报。

执照

Apache 许可证 2.0