Weather MCP Server

基本能力

产品定位

Weather MCP Server 是一个天气信息服务，旨在为开发者和 AI 助手提供全球城市的天气数据。

核心功能

• 获取任何城市的当前天气信息
• 提供温度、天气状况、湿度、风力等详细信息
• 支持两种数据模式：实时 API 数据和模拟数据
• 当 API 请求失败或未提供 API 密钥时自动回退到模拟数据

适用场景

• 为 AI 助手提供天气查询功能
• 开发需要天气数据的应用程序
• 测试和开发环境下的天气数据模拟

工具列表

• get_current_weather: 获取指定城市的当前天气信息
• 输入: 城市名称
• 输出: 包含位置、日期时间、温度、天气状况、湿度、风力等详细信息

常见问题解答

• 如何获取 OpenWeather API 密钥？
• 在 OpenWeather 网站注册账号
• 导航到账户的 "API keys" 部分
• 生成或使用现有的 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": []
    }
  }
}

调试方式

• 检查服务器是否正常运行: npm start
• 测试天气查询功能
• 检查响应中的 source 字段确认数据来源

许可证

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