🚀 天气 MCP 服务器

天气 MCP 服务器是一个提供来自国家气象局 API 天气数据的模型上下文协议 (MCP) 服务器，能为用户提供准确且格式化的天气信息，还可与 Claude 等客户端集成。

🚀 快速开始

天气 MCP 服务器能帮助你轻松获取天气数据。以下是使用前的准备步骤：

先决条件

• Node.js（推荐使用 LTS 版本）
• npm 或 yarn 包管理器

安装步骤

1. 克隆仓库

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

2. 安装依赖项

npm install

3. 构建服务器

npm run build

✨ 主要特性

• 精准预报：可根据地理位置获取天气预报。
• 警报提醒：能根据美国州份获取天气警报。
• 数据适配：提供干净、格式化的天气数据供 LLM 使用。
• 广泛兼容：可集成与 Claude 和其他兼容 MCP 的客户端。

💻 使用示例

直接运行服务器

npm start

或直接运行：

./dist/index.js

与 Claude Desktop 连接

1. 编辑你的 Claude Desktop 配置文件：

# MacOS 系统
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 添加天气 MCP 服务器配置：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/绝对路径/到你的/weather-mcp/dist/index.js"]
    }
  }
}

3. 重启 Claude Desktop
4. 使用以下查询测试服务器：
   • "Sacramento 的天气怎么样？"
   • "Texas 有没有生效的天气警报？"

📚 详细文档

可用工具

get_forecast

获取某个地理位置的天气预报。 参数:

• latitude: 地点纬度（-90 到 90 之间的数字）
• longitude: 地点经度（-180 到 180 之间的数字）

get_alerts

获取美国州份的生效天气警报。 参数:

• state: 美国两个字母的州代码（例如 "CA"，"NY"，"TX"）

资源模板

按州查询天气警报

URI 模板: weather://{state}/alerts 示例: weather://CA/alerts

限制

• 天气数据仅限于美国地区（NWS API）
• 没有历史天气数据，仅有当前状况和预报

开发

• 以开发模式运行: npm run dev
• 构建项目: npm run build

📄 许可证

本项目采用 ISC 许可证。