天气 MCP 服务器

一个提供美国地区天气信息和警报的模型上下文协议（MCP）服务器，使用国家气象局（NWS）API。该服务器专为AI代理通过模型上下文协议设计。

特性

• 获取特定美国州份天气警报的工具
• 使用坐标获取任何地理位置详细天气预报的工具
• 支持温度、风力条件和简要天气描述
• 来自国家气象局的实时数据

先决条件

• Node.js（v16或更高版本）
• npm 或 yarn 包管理器

安装

1. 克隆仓库：

git clone https://github.com/akaramanapp/weather-mcp-server.git
cd weather-mcp-server

2. 安装依赖项：

npm install

3. 构建应用程序：

npm run build

MCP 工具

该服务器提供两个MCP工具，供AI代理使用：

get-alerts

获取特定美国州份的天气警报。

参数：

• state：两位字母的状态代码（例如CA、NY）

示例响应：

{
  "content": [
    {
      "type": "text",
      "text": "CA 状态的活跃警报：..."
    }
  ]
}

get-forecast

使用坐标获取特定位置的天气预报。

参数：

• latitude：位置的纬度（-90 到 90）
• longitude：位置的经度（-180 到 180）

示例响应：

{
  "content": [
    {
      "type": "text",
      "text": "早晨：温度：72°F，风速：5mph NW，多云..."
    }
  ]
}

项目结构

weather/
├── src/
│   └── index.ts    # 主服务器代码，包含MCP工具实现
├── build/          # 编译后的 JavaScript 文件
├── package.json    # 项目依赖和脚本
└── tsconfig.json   # TypeScript 配置

技术细节

• 使用 TypeScript 开发
• 实现模型上下文协议（MCP）服务器
• 使用 @modelcontextprotocol/sdk 进行MCP服务器实现
• 与国家气象局（NWS）API接口交互
• 目标为 ES2022，使用 Node16 模块解析

开发

要修改或扩展服务器：

1. 在 src/index.ts 文件中进行更改
2. 重建应用程序：

npm run build

依赖项

• @modelcontextprotocol/sdk：MCP 服务器实现框架
• zod：工具参数的运行时类型检查和验证
• TypeScript：用于类型安全的开发依赖

许可证

ISC

注意事项

• 该服务器仅适用于美国地区，因为它使用国家气象局 API
• API 请求受到速率限制，并且需要 User-Agent 标头
• 所有坐标应为十进制度数格式
• 这不是一个独立的 CLI 应用程序，而是一个通过模型上下文协议为AI代理提供工具的服务器