AI导哈

天气查询服务器

一个提供实时天气查询和预报服务的MCP服务器，支持多种天气相关查询功能。

  • by Han-taz
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Han-taz/mcp-server

使用说明

韩国气象MCP服务器

“首尔天气怎么样？” 如果问的话，就是告知实时天气的MCP服务器。

我可以做这些。

👤 "강남역 지금 날씨 어때?"
🤖 서울 강남역 현재 날씨
   🌡️ 기온: 5°C (체감 2°C)
   💧 습도: 45%
   🌤️ 맑음

👤 "내일 부산 비 와?"
🤖 내일 부산은 오후부터 비 소식이 있어요. 우산 챙기세요!

👤 "이번 주말 제주도 날씨 좋을까?"
🤖 토요일은 맑고 포근하지만, 일요일은 흐리고 바람이 강할 예정이에요.

5分钟内安装

1.发放API密钥

API 发件人 所需时间
气象厅 公共数据门户 立即（自动批准）
Kakao Kakao开发商 立即

2.安装和运行

# 1) 저장소 클론
git clone https://github.com/YOUR_USERNAME/mcp-server.git
cd mcp-server

# 2) 환경변수 설정
cp .env.example .env
# .env 파일 열어서 API 키 입력

# 3) 설치 & 실행
uv sync
uv run python main.py

💡 uv如果没有： curl -LsSf https://astral.sh/uv/install.sh | sh

3.连接Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json 编辑：

{
  "mcpServers": {
    "korea-weather": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Claude Desktop重启就结束了！

交付工具

工具 说明 示例问题
get_current_weather 当前天气“现在首尔天气”
get_hourly_forecast 【时间预报】“今天下午下雨吗？”
get_daily_forecast 每日预报“本周天气”
check_umbrella_needed 是否需要雨伞？“明天要带雨伞吗？”
get_weather_advice 推荐活动“周末可以去爬山吗？”

故障排除

验证设置

uv run python -m src.weather.verify

所有项目都是的话就正常了。

常见问题

症状 解决方案
“API密钥无效” .env 检查文件的API密钥
“Connection required” 验证服务器运行（uv run python main.py)
气象局403错误 公共数据门户检查API批准状态
找不到位置 输入更具体的地址（例如“首尔江南区”）

开发

# 테스트
uv run pytest

# 린트 & 포맷
uv run ruff check src tests
uv run ruff format src tests

# 타입 체크
uv run mypy src

许可证

MIT许可证

相关 MCP