MCP 天气服务器

一个使用模型上下文协议 (MCP) 构建的天气服务器应用程序，提供对实时天气数据和警报的访问。

概述

MCP 天气服务器是一个 TypeScript 应用程序，用作使用 MCP SDK 的天气相关应用程序的后端。 它提供了通过国家气象局 (NWS) API 访问当前天气状况、预报和天气警报的工具。

特性

• 美国天气预报：通过经纬度获取美国任何地点的详细预报数据
• 天气警报：检索美国任何州的有效天气警报
• MCP 集成：构建为 MCP 服务器，用于无缝 AI 助手集成
• 命令行界面：易于安装并作为 CLI 工具运行

架构

该应用程序使用模型上下文协议 (MCP) 框架构建：

1. MCP 服务器层：处理与 MCP 客户端的通信
2. 天气工具：实现预报和警报功能
3. 外部 API 集成：连接到国家气象局 (NWS) API

组件结构

该服务器包括两个主要的天气工具：

• get-forecast：检索由经度和纬度指定的位置的详细天气预报
• get-alerts：获取指定美国州的有效天气警报

这些工具与国家气象局 API 通信，以提供可靠的天气数据。

技术栈

• Node.js
• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• 国家气象局 API
• Zod (用于输入验证)

快速开始

前提条件

• 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

2. 通过 MCP 兼容的客户端/助手： 配置您的 MCP 客户端以使用天气工具进行预报和天气警报。

API 用法

获取天气预报

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

获取天气警报

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

数据来源

该服务器使用国家气象局 API，该 API 提供美国的官方天气数据。 由于此数据源的限制，该应用程序目前仅支持美国境内的位置。

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

该项目根据 ISC 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。