天气警报和预报服务器

气象MCP服务器

该项目是一个天气MCP（模型上下文协议）服务器，使用美国国家气象局（NWS）API提供天气警报和预报。它是使用 @modelcontextprotocol/sdk 包裹。

特性

• 获取天气警报：检索美国特定州的活动天气警报。
• 获取天气预报：使用纬度和经度检索特定位置的天气预报。

先决条件

• Node.js（版本16或更高）
• 互联网连接（用于访问NWS API）

安装

1. 克隆存储库：

   复制

   git clone <repository-url>
   cd weather
   

2. 安装依赖项：

   复制

   npm install
   

工具

服务器提供以下工具：

1. get-alerts

• 描述：获取一个州的天气警报。
• 输入:
  • state （string）：两个字母的状态码（例如。， CA, NY).
• 输出：指定状态的活动天气警报。

2. get-forecast

• 描述：获取某个地点的天气预报。
• 输入:
  • latitude （数字）：位置的纬度。
  • longitude （数字）：位置的经度。
• 输出：指定地点的天气预报。

发展

项目结构

• src/index.ts：主服务器实现。
• build/index.js：编译的JavaScript输出。

脚本

• npm start：启动服务器。
• npm run build：将TypeScript编译为JavaScript。

TypeScript配置

该项目使用 tsconfig.json TypeScript配置文件。

API详细信息

服务器与美国国家气象局（NWS）API进行交互。以下是使用的关键端点：

• 警报: https://api.weather.gov/alerts?area={state}
• 要点: https://api.weather.gov/points/{latitude},{longitude}
• 预测：由积分API提供的URL。

错误处理

服务器包括API请求的错误处理。如果发生错误，将返回一条描述性消息。

许可证

该项目根据MIT许可证获得许可。