双源天气 MCP 服务器

双源天气 MCP 服务器

site icon
2025.03.04 0
TypeScript天气服务数据服务位置服务
双源天气 MCP 服务器是一个基于 Model Context Protocol (MCP) 的天气服务器,使用和风天气和心知天气API提供天气数据,支持故障转移和优先获取最快响应。它主要用于提供天气数据服务,包括当前天气和天气预报,适用于需要天气信息的应用场景。
View on GitHub

Overview

基本能力

产品定位

双源天气 MCP 服务器是一个基于 Model Context Protocol (MCP) 的天气服务器,使用和风天气和心知天气API提供天气数据,支持故障转移和优先获取最快响应。

核心功能

  • 查看当前天气 (作为资源提供)
  • 获取指定城市的当前天气 (工具)
  • 获取指定城市的天气预报 (工具)
  • 同时使用多个API源,自动选择最快响应的结果
  • 支持最低/最高温度、湿度和风速数据

适用场景

  • 需要天气信息的应用
  • 需要高可用性天气数据的服务
  • 需要快速响应天气数据的场景

工具列表

  • getCurrentWeather - 获取指定城市的当前天气
  • getForecast - 获取指定城市的天气预报(支持1-7天)

常见问题解答

  • 故障转移机制:服务器同时使用多个天气API源,优先采用最先返回响应的API结果,如果某个API失败,会自动使用另一个API的结果。

使用教程

使用依赖

  1. 安装 Node.js
  2. 克隆仓库
git clone <repository-url>
cd weather-mcp-server
  1. 安装依赖
npm install
  1. 配置环境变量
cp .env.example .env
# 编辑 .env 文件,添加你的API密钥

安装教程

  1. 构建项目
npm run build
  1. 运行项目
npm start

调试方式

  1. 查看 MCP 的日志
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  1. 使用 MCP Inspector 调试
npx @modelcontextprotocol/inspector node 你的完整路径/weather-mcp-server/build/index.js

然后在浏览器中访问 http://localhost:5173

许可证

该项目遵循 MIT 开源许可条款。