Weather MCP Server

Weather MCP Server

一个模型上下文协议（MCP）服务，使用美国国家气象局 API 为美国境内地点提供天气预警和预报。

功能

• get-alerts：获取美国某州的有效天气预警（使用两位字母代码，例如 CA、NY）。
• get-forecast：获取指定经纬度的天气预报。

要求

• Node.js v16 或更高版本
• npm（随 Node.js 一同提供）

设置

1. 将此仓库克隆或复制到你的计算机。
2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

运行服务

启动服务（用于本地开发或直接使用）：

npm start

或者，直接运行构建后的服务：

node build/index.js

MCP 集成（Claude for Desktop 示例）

要将此服务与 Claude for Desktop 或其他 MCP 主机搭配使用，请将以下内容添加到 claude_desktop_config.json（根据需要更新路径）：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/weather-mcp/build/index.js"
      ]
    }
  }
}

• 将 /ABSOLUTE/PATH/TO/weather-mcp/build/index.js 替换为构建后的服务文件的绝对路径。
• 保存并重启 MCP 主机（例如 Claude for Desktop）。

用法

连接后，你可以使用以下工具：

get-alerts

• **描述：**获取美国某州的天气预警。
• 输入：state（字符串，两位字母的美国州代码，例如 "CA"）
• **输出：**有效预警列表；若未找到预警，则显示一条消息。

get-forecast

• **描述：**获取某个地点的天气预报。
• 输入：
  • latitude（数字，例如 37.7749）
  • longitude（数字，例如 -122.4194）
• **输出：**未来若干时段的天气预报。

开发

• 编辑 src/index.ts 以修改或扩展服务。
• 修改后运行 npm run build。

许可证

MIT