Weather MCP Server

一个模型上下文协议 (MCP) 服务器，提供世界各地城市的天气信息。

功能

• 获取任何城市的当前天气
• 提供温度、天气状况、湿度、风力信息等
• 如果 API 请求失败，则回退到模拟数据

要求

• Node.js (v14 或更高版本)
• npm 或 yarn
• OpenWeather API 密钥（可选 - 如果未提供，将使用模拟数据）

安装

1. 克隆此存储库
2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

用法

在本地运行

npm start

与 Claude 或其他 MCP 兼容的 AI 助手一起使用

将以下配置添加到您的 MCP 设置：

{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": ["path/to/weather-server/build/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here" // 可选 - 如果未提供，将使用模拟数据
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API 密钥和模拟数据

此服务器可以在两种模式下运行：

1. 使用 API 密钥：当通过 OPENWEATHER_API_KEY 环境变量提供 OpenWeather API 密钥时，服务器将从 OpenWeather API 获取实时天气数据。

2. 不使用 API 密钥：如果未提供 API 密钥，服务器将自动使用一组预定义城市（伦敦、纽约、东京、巴黎、悉尼）的模拟数据。 对于其他城市，它将使用默认的模拟数据。

要获取 OpenWeather API 密钥：

1. 在 OpenWeather 注册
2. 导航到您帐户的“API 密钥”部分
3. 生成新的 API 密钥或使用现有的 API 密钥

模拟数据模式对于开发、测试或您不需要实时天气数据时非常有用。

可用工具

get_current_weather

获取指定城市的当前天气信息。

输入模式：

{
  "city": "string" // 城市名称（例如，“伦敦”、“纽约”、“东京”）
}

示例响应：

{
  "location": "London, GB",
  "date": "Monday, March 24, 2025",
  "time": "7:30:00 PM",
  "temperature": {
    "current": "12°C",
    "feelsLike": "10°C"
  },
  "weather": {
    "main": "Cloudy",
    "description": "Overcast clouds",
    "icon": "https://openweathermap.org/img/wn/04d@2x.png"
  },
  "details": {
    "humidity": "75%",
    "pressure": "1012 hPa",
    "windSpeed": "4.5 m/s",
    "windDirection": "230°",
    "cloudiness": "90%",
    "sunrise": "6:45 AM",
    "sunset": "7:30 PM"
  },
  "source": "OpenWeather API" // 或 "Mock Data (No API key provided)" 或 "Mock Data (API request failed)"
}

响应中的 source 字段指示数据来源：

• "OpenWeather API"：来自 OpenWeather API 的实时数据
• "Mock Data (No API key provided)"：由于未提供 API 密钥而使用的模拟数据
• "Mock Data (API request failed)"：由于 API 请求失败而使用的模拟数据

许可证

MIT