韩国天气 MCP 服务器
该 MCP（多平台通信协议）服务器提供对韩国气象局 (KMA) API 的访问，允许 AI 代理检索韩国各地的天气预报信息。
概述
Related MCP server: Weather MCP Server
目录
设置
先决条件
安装
克隆存储库：
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 询问以下问题：
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 文件。
