Akaramanapp Weather MCP Server

🚀 天气 MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，借助国家气象局（NWS）API，为用户提供美国地区的天气信息与警报。它专为 AI 代理通过模型上下文协议使用而设计，能有效满足相关需求。

🚀 快速开始

本服务器专为 AI 代理通过模型上下文协议设计，要使用它，你需要完成以下步骤：

1. 确保满足先决条件，即安装 Node.js（v16 或更高版本）以及 npm 或 yarn 包管理器。
2. 按照安装指南克隆仓库、安装依赖项并构建应用程序。

✨ 主要特性

• 提供获取特定美国州份天气警报的工具，让你及时掌握当地天气动态。
• 支持使用坐标获取任何地理位置的详细天气预报，无论你身处何方，都能精准了解天气情况。
• 涵盖温度、风力条件和简要天气描述等信息，满足你对天气信息的基本需求。
• 数据来自国家气象局，确保信息的实时性和准确性。

📦 安装指南

先决条件

• 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 配置

开发

要修改或扩展服务器：

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

npm run build

依赖项

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

🔧 技术细节

• 使用 TypeScript 开发，保证代码的类型安全和可维护性。
• 实现模型上下文协议（MCP）服务器，为 AI 代理提供服务。
• 使用 @modelcontextprotocol/sdk 进行 MCP 服务器实现，提高开发效率。
• 与国家气象局（NWS）API 接口交互，获取实时天气数据。
• 目标为 ES2022，使用 Node16 模块解析，确保项目的兼容性和性能。

📄 许可证

本项目采用 ISC 许可证。

注意事项

⚠️ 重要提示

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