Weather API MCP Server

Weather API MCP Server

site icon
2025.03.30 0
JavaScript天气服务API集成位置服务
mcp-weather-server 是一个基于 Model Context Protocol (MCP) 的天气信息服务,提供当前天气数据、天气预报、小时预报以及城市查询功能。该服务通过集成和风天气 (QWeather) API 来获取准确的天气数据,支持多种配置选项,如单位、语言和详细程度。
View on GitHub

Overview

基本能力

产品定位

mcp-weather-server 是一个天气信息服务,旨在为开发者提供简单易用的天气数据接口,支持多种天气查询功能。

核心功能

  • 当前天气:获取任意地点的当前天气数据。
  • 天气预报:提供3天至30天的天气预报。
  • 小时预报:提供24小时的天气小时预报。
  • 城市查询:查询城市信息及ID,用于更精确的天气数据获取。
  • 自定义选项:支持配置单位、语言等选项。

适用场景

  • 需要实时天气数据的应用开发。
  • 需要天气预报功能的旅行或户外活动应用。
  • 需要小时预报的天气监控系统。

工具列表

  1. getWeather:获取当前天气数据。
  2. getWeatherForecast:获取天气预报数据。
  3. getHourlyWeather:获取小时天气预报数据。
  4. lookupCity:查询城市信息及ID。

常见问题解答

  • API密钥:默认包含演示用API密钥,生产环境需自行申请。
  • 位置格式:支持城市名称、坐标或QWeather位置ID。

使用教程

使用依赖

  • Node.js 16或更高版本
  • npm或yarn

安装教程

npm install mcp-weather-api

或直接使用npx:

npx mcp-weather-api

调试方式

  1. 克隆仓库
  2. 安装依赖:
npm install
  1. 运行开发模式:
npm run dev

许可证

None