Weather MCP Server

Weather MCP Server

site icon
2025.03.21 0
JavaScript天气数据服务天气预报天气警报位置服务
Weather MCP Server 是一个基于模型上下文协议(MCP)的服务,提供来自美国国家气象局API的天气数据。它能够获取地理坐标的天气预报、美国各州的天气警报,并为LLM(大型语言模型)提供干净、格式化的天气数据。该服务支持与Claude及其他MCP兼容客户端的集成。
View on GitHub

Overview

基本能力

产品定位

Weather MCP Server 是一个天气数据服务,专门为需要集成天气信息的应用程序或服务提供支持。

核心功能

  • 通过地理坐标获取天气预报
  • 获取美国各州的天气警报
  • 为LLM提供干净、格式化的天气数据
  • 与Claude及其他MCP兼容客户端的集成

适用场景

  • 需要实时天气信息的应用程序
  • 需要天气警报服务的美国地区应用
  • 集成天气数据到大型语言模型的场景

工具列表

  • get_forecast: 获取地理位置的天气预报。参数包括latitude(纬度)和longitude(经度)。
  • get_alerts: 获取美国某州的活跃天气警报。参数为state(两字母州代码)。

常见问题解答

  • 数据限制: 天气数据仅限于美国地区(NWS API)。
  • 历史数据: 不支持历史天气数据,仅提供当前状况和预报。

使用教程

使用依赖

  • Node.js(推荐LTS版本)
  • npm或yarn

安装教程

  1. 克隆仓库
git clone https://github.com/nakamurau1/weather-mcp.git
cd weather-mcp
  1. 安装依赖
npm install
  1. 构建服务器
npm run build

调试方式

  • 运行服务器
npm start

或直接运行

./dist/index.js
  • 开发模式运行
npm run dev
  • 构建项目
npm run build

连接Claude Desktop

  1. 编辑Claude Desktop配置文件
# MacOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加weather-mcp服务器配置
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/absolute/path/to/your/weather-mcp/dist/index.js"]
    }
  }
}
  1. 重启Claude Desktop
  2. 测试服务器,例如:
  3. "What's the weather in Sacramento?"
  4. "Are there any active weather alerts in Texas?"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。