Weather MCP Server

Weather MCP Server

一个 Model Context Protocol（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" // Optional - will use mock data if not provided
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API 密钥和模拟数据

此服务支持两种运行模式：

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

2. 不使用 API 密钥：如果未提供 API 密钥，服务将自动为一组预定义城市（London、New York、Tokyo、Paris、Sydney）使用模拟数据。对于其他城市，则使用默认模拟数据。

获取 OpenWeather API 密钥：

1. 在 OpenWeather 注册
2. 前往账户中的“API keys”部分
3. 生成新的 API 密钥，或使用现有密钥

模拟数据模式适用于开发、测试或不需要实时天气数据的场景。

可用工具

get_current_weather

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

输入架构：

{
  "city": "string" // City name (e.g., "London", "New York", "Tokyo")
}

响应示例：

{
  "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/[email protected]"
  },
  "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" // or "Mock Data (No API key provided)" or "Mock Data (API request failed)"
}

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

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

许可证

MIT