返回 MCP 目录
public公开dns本地运行

mcp-server-pao

一个基于OpenWeatherMap API的天气MCP服务器,提供实时天气数据和5天天气预报,支持多种单位格式和缓存优化。

article

README

🚀 Weather MCP 服务器

Weather MCP 服务器是一个 Cline MCP 服务器,借助 OpenWeatherMap API 为用户提供实时的天气数据,满足用户对全球天气信息的查询需求。

🚀 快速开始

Weather MCP 服务器可帮助你轻松获取全球各地的天气信息。你只需按照以下步骤操作,即可快速使用该服务。

✨ 主要特性

  • 实时天气查询:能够获取全球任何地点的当前天气状况。
  • 未来天气预测:可获取未来五天的天气预报信息。
  • 单位制支持:支持.metric 和 imperial 两种单位制。
  • 高效缓存机制:采用效率缓存以最小化 API 调用。
  • 美观响应格式:提供美观格式化的 Markdown 响应。

📦 安装指南

  1. 首先,你需要在 OpenWeatherMap 注册免费 API 密钥。
  2. 克隆此仓库:
    git clone https://github.com/yourusername/weather-mcp.git
    cd weather-mcp
    npm install
    npm run build
    
  3. 将 MCP 服务器添加到您的 Cline 设置中:
    {
      "mcpServers": {
        "weather-mcp": {
          "command": "node",
          "args": [
            "/path/to/weather-mcp/build/index.js"
          ],
          "env": {
            "OPENWEATHERMAP_API_KEY": "YOUR_API_KEY",
            "WEATHER_UNITS": "metric"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
    
  4. 设置 WEATHER_UNITS 为.metric(°C,m/s)或 imperial(°F,mph)。

💻 使用示例

基础用法

获取当前天气状况

# 使用 get_current_weather 工具获取当前天气
# 假设要获取伦敦的当前天气
get_current_weather --location "London"

获取未来天气预报

# 使用 get_weather_forecast 工具获取未来天气预报
# 假设要获取伦敦未来 3 天的天气预报
get_weather_forecast --location "London" --days 3

高级用法

# 如果你想获取带国家代码的城市的未来 5 天天气预报
get_weather_forecast --location "London,uk" --days 5

📚 详细文档

可用工具

get_current_weather

此工具用于获取指定位置的当前天气状况。 参数:

  • location: 城市名称(例如 'London'),或带国家代码的城市名称(例如 'London,uk')

get_weather_forecast

此工具用于获取指定位置的未来五天天气预报。 参数:

  • location: 城市名称(例如 'London'),或带国家代码的城市名称(例如 'London,uk')
  • days: 预报的天数(1 - 5,默认值:3)

🔧 技术细节

本项目在开发过程中,为了提高性能和减少 API 调用次数,采用了效率缓存机制。同时,使用 OpenWeatherMap API 来获取全球的天气数据,确保数据的准确性和及时性。在响应格式上,采用了美观的 Markdown 格式,方便用户查看和使用。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端