Weather 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 工具

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

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 西北风，多云..."
    }
  ]
}

项目结构

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 代理提供工具的服务器