MCP Weather Server

MCP Weather Server

site icon
2025.03.12 0
TypeScript天气服务后端服务位置服务
MCP Weather Server 是一个基于 Model Context Protocol (MCP) 构建的天气服务应用,提供实时天气数据和警报访问。该应用使用 TypeScript 开发,作为天气相关应用的后端,通过 MCP SDK 提供对美国国家气象局 (NWS) API 的访问。
View on GitHub

Overview

基本能力

产品定位

MCP Weather Server 是一个专注于提供实时天气数据和警报的后端服务,适用于需要天气信息的应用和 AI 助手。

核心功能

  • 美国天气预报:通过经纬度获取美国任何地点的详细天气预报数据。
  • 天气警报:获取美国任何州的活跃天气警报。
  • MCP 集成:作为 MCP 服务器,便于与 AI 助手无缝集成。
  • 命令行界面:易于安装和作为 CLI 工具运行。

适用场景

  • 需要实时天气数据的应用后端。
  • AI 助手或聊天机器人集成天气服务。
  • 开发者需要快速获取美国天气信息的工具。

工具列表

  • get-forecast:根据经纬度获取详细天气预报。
  • get-alerts:获取指定美国州的活跃天气警报。

常见问题解答

  • 数据源限制:目前仅支持美国地区的天气数据。
  • 安装问题:确保 Node.js 版本为 v18 或更高。

使用教程

使用依赖

  • Node.js (v18 或更高)
  • npm 或 yarn

安装教程

# 克隆仓库
git clone https://github.com/cskiro/MCP-Weather-Server.git

# 进入项目目录
cd MCP-Weather-Server

# 安装依赖
npm install

# 构建项目
npm run build

# 使 CLI 可执行
chmod +x build/index.js

# 全局安装(可选)
npm install -g .

调试方式

  1. 直接调用
weather
  1. 通过 MCP 兼容客户端/助手:配置 MCP 客户端以使用天气工具获取预报和警报。

API 使用示例

获取天气预报

// 示例:获取旧金山的天气预报
{
  latitude: 37.7749,
  longitude: -122.4194
}

获取天气警报

// 示例:获取加利福尼亚州的天气警报
{
  state: "CA"
}

许可证

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