项目介绍
韩国天气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
- 安装uv
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：
uv run src/migrate.py
使用Docker
- 构建Docker镜像：
docker build -t py-mcp-ko-weather .
- 运行容器：
docker run py-mcp-ko-weather
使用本地
- 运行服务器：
mcp run src/server.py
- 运行MCP Inspector
mcp dev server.py
配置MCP设置
将服务器配置添加到您的MCP设置文件中：
Claude桌面应用
- 通过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"
]
}
}
}
Cursor 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
调用KMA的超短期预报API以提供特定位置的天气预报信息。返回包括温度、降水量、天空状况、湿度、风向和风速在内的全面天气数据。
资源
天气说明
GET weather://instructions
提供关于如何使用韩国天气MCP服务器的详细文档，包括工具工作流程和响应格式。
提示
天气查询
服务器包含一个结构化的提示模板，用于引导有关天气查询的对话，确保高效的信息收集和清晰的预报数据展示。
响应格式
天气预报响应以结构化文本格式提供，优化用于LLM处理：
首尔特别市瑞草区良才1洞（坐标：nx=61, ny=125）的天气预报
日期：2025-05-01
时间：15:00
当前情况：
温度：22.3°C
天空状况：大部分晴朗
降水类型：无
降水概率：0%
湿度：45%
风向：西北
风速：2.3 m/s
每小时预报：
16:00 - 温度：21.8°C，天空：晴朗，降水：无
17:00 - 温度：20.5°C，天空：晴朗，降水：无
18:00 - 温度：19.2°C，天空：晴朗，降水：无
...
致谢
许可证
本项目采用MIT许可证 - 查看LICENSE文件了解详情。