天气数据服务

一个基于Model Context Protocol (MCP)的天气数据服务器,提供美国各州的天气警报和特定位置的天气预报。

  • by BhavinPatel04
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 BhavinPatel04/weather-mcp-server

使用说明

天气MCP服务器

这个项目是一个模型上下文协议(MCP)服务器,它利用国家气象局(NWS)API提供天气数据和警报。它提供了工具,用于检索美国某州的活跃天气警报以及给定经纬度的天气预报。

特点/功能

  • 获取美国任何州的实时天气警报
  • 获取特定位置(纬度/经度)的天气预报
  • 使用MCP服务器实现 @modelcontextprotocol/sdk

使用方法

先决条件

  • Node.js(建议使用v18或更高版本)
  • npm 或 yarn

安装依赖项

npm install

运行服务器

npm start

API工具

get_alerts

获取美国某州的实时天气警报。

  • 输入: state (字符串,两个字母的代码,例如“CA”,“NY”)
  • 输出: 当前激活警报的列表,或若无激活警报则显示一条消息。

get_forecast

获取某个地点的天气预报。

  • 输入: latitude (数字), longitude (数字)
  • 输出: 该地点的预测时段。

项目结构

weather/
├── src/
│   ├── index.ts        # MCP server implementation
│   └── helper.ts       # Helper functions and types
├── build/              # Compiled JS output
├── package.json        # Project metadata and dependencies
├── tsconfig.json       # TypeScript configuration

许可证

麻省理工学院(MIT)