韩国天气 MCP 服务器
该 MCP（多平台通信协议）服务器提供对韩国气象局 (KMA) API 的访问，允许 AI 代理检索韩国各地的天气预报信息。
概述
- 检索韩国行政区域的精确网格坐标
- 获取韩国任何地点的详细短期天气预报
- 支持韩国所有行政区划（市、区、街道）
- 针对 LLM 使用进行了优化的结构化文本响应
- 综合天气数据，包括温度、降水、天空状况、湿度、风向和风速
目录
设置
先决条件
- Python 3.12+
- 韩国气象局 API 凭证
- 您可以通过在公共数据门户注册并请求访问“기상청_단기예보 ((구)_동네예보) 조회서비스”API 来获取 API 凭据。
安装
- 克隆存储库：
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 venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txt
- 使用您的 KMA API 凭据创建一个
.env文件：
cp env.example .env
vi .env
KO_WEATHER_API_KEY=your_api_key_here
- 将网格坐标数据从 Excel 迁移到 SQLite：
使用 Docker
- 构建 Docker 镜像：
docker build -t py-mcp-ko-weather .
- 运行容器：
docker run py-mcp-ko-weather
使用本地
- 运行服务器：
配置 MCP 设置
将服务器配置添加到您的 MCP 设置文件：
克劳德桌面应用程序
- 要通过Smithery自动安装：
npx -y @smithery/cli install @jikime/py-mcp-ko-weather --client claude
- 要手动安装，请打开
~/Library/Application Support/Claude/claude_desktop_config.json
将其添加到mcpServers对象：
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-ko-weather",
"run",
"src/server.py"
]
}
}
}
游标 IDE
打开~/.cursor/mcp.json
将其添加到mcpServers对象：
{
"mcpServers": {
"Google Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-ko-weather",
"run",
"src/server.py"
]
}
}
}
对于 Docker
{
"mcpServers": {
"Google Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"py-mcp-ko-weather"
]
}
}
}
与 Claude 一起使用
配置完成后，您可以向 Claude 询问以下问题：
- “서울특별시 서초구 양재1동의 날씨는？”
- “부산광역시 해운대구 우동의 날씨 예보를 알려줘”
- “경기도 성남시 분당구의 현재 기온은？”
API 参考
工具
获取网格位置
get_grid_location(city: str, gu: str, dong: str) -> dict
检索韩国气象局 API 针对指定位置使用的网格坐标 (nx, ny)。此工具会根据市/道、区/县以及街区/城镇信息，在数据库中搜索精确坐标。
获取预测
get_forecast(city: str, gu: str, dong: str, nx: int, ny: int) -> str
调用韩国气象局的超短期预报 API，提供特定地点的天气预报信息。返回包括温度、降水量、天空状况、湿度、风向和风速在内的综合天气数据。
资源
天气说明
GET http://localhost:8000/weather-instructions
提供有关如何使用韩国天气 MCP 服务器的详细文档，包括工具工作流程和响应格式。
提示
天气查询
该服务器包含一个结构化的提示模板，用于引导有关天气查询的对话，确保高效的信息收集和清晰的预报数据呈现。
响应格式
天气预报响应以结构化文本格式提供，针对 LLM 处理进行了优化：
Weather forecast for 서울특별시 서초구 양재1동 (coordinates: nx=61, ny=125)
Date: 2025-05-01
Time: 15:00
Current conditions:
Temperature: 22.3°C
Sky condition: Mostly clear
Precipitation type: None
Precipitation probability: 0%
Humidity: 45%
Wind direction: Northwest
Wind speed: 2.3 m/s
Hourly forecast:
16:00 - Temperature: 21.8°C, Sky: Clear, Precipitation: None
17:00 - Temperature: 20.5°C, Sky: Clear, Precipitation: None
18:00 - Temperature: 19.2°C, Sky: Clear, Precipitation: None
...
致谢
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。