天气 MCP 服务器

天气 MCP 服务器

site icon
2025.04.22 0
Python天气服务空气质量监测位置服务
天气 MCP 服务器是一个基于 OpenWeather API 的 Model Context Protocol (MCP) 服务器,主要用于获取全球城市的详细天气预报和空气质量信息。该服务器支持最多5天的天气预报查询,并能提供实时的空气质量数据。适用于需要天气信息的各种应用场景。
View on GitHub

Overview

基本能力

产品定位

天气 MCP 服务器是一个专门用于获取天气数据和空气质量信息的 MCP 服务器,通过 OpenWeather API 提供全球城市的天气服务。

核心功能

  • 获取任何城市的详细天气预报(最多5天)
  • 获取任何城市的当前空气质量信息

适用场景

  • 需要集成天气信息的应用程序
  • 需要实时空气质量数据的服务
  • 天气预报查询工具

工具列表

  • OpenWeather API:用于获取天气和空气质量数据
  • FastMCP 框架:实现 MCP 协议
  • Python requests 库:进行 API 交互

常见问题解答

  • 如果遇到关于 API 密钥的错误,确保在命令行参数中正确提供了 API 密钥
  • 确保网络可以访问 OpenWeather API
  • 检查 MCP 客户端中的服务器配置是否正确

使用教程

使用依赖

  • Python 3.11+
  • OpenWeather API 密钥(可在 OpenWeather 获取)
  • Anthropic Claude Desktop 应用(或其他 MCP 客户端)
  • UV 包管理工具(https://github.com/astral-sh/uv)

安装教程

  1. 克隆仓库 bash git clone https://github.com/odinggg/weather-mcp.git cd weather-mcp
  2. 连接到 MCP 服务器 将以下 JSON 配置添加到您的 MCP 客户端(例如 Claude Desktop)中: json { "mcpServers": { "weather": { "command": "uv", "args": [ "--directory", "/your/path/to/weather-mcp", "run", "-m", "weather_mcp_server.main", "--api-key", "xxxxxxxxxxxxxxx" ] } } } 对于 Claude Desktop,将此保存为 claude_desktop_config.json,位置在: ~/Library/Application Support/Claude/claude_desktop_config.json

调试方式

  • 使用示例提示测试服务器功能:
  • "未来 3 天北京的天气预报是什么?"
  • "现在上海的空气质量如何?"
  • 检查日志文件以查看服务器运行状态

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。