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)
• 国家气象局（NWS）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 使用说明

获取天气预报

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

获取天气警报

// 示例：查询加利福尼亚州的天气警报
{
  州: "CA"
}

数据来源

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

贡献指南

欢迎任何贡献！请随时通过 Pull Request 提交代码或建议。

许可证

此项目采用 ISC 许可证，具体内容请查阅 LICENSE 文件。