天气数据服务

一款基于OpenWeather API的天气数据服务,提供实时天气和5天天气预报,支持STDIO和SSE两种传输模式,适用于需要天气数据的应用场景。

  • by 123liu950
  • JavaScript
  • 混合部署
  • 更新于
在 GitHub 查看 123liu950/weather-mcp

使用说明

气象MCP服务器🌤️

模型上下文协议(MCP)服务器,从OpenWeather API提供天气数据。支持两者 工作室 和 上海证券交易所 运输方式。

英语 | 中文


英语

特性

  • 🌡️ 实时天气 -获取任何城市的当前天气
  • 📅 5天预测 -获取长达5天的天气预报
  • 🌍 双语支持 -适用于中英文城市名称
  • 🔌 双重运输 -支持STDIO和SSE模式
  • 🔑 灵活的身份验证 -通过URL、Header或环境变量的API密钥

安装

选项1:NPX(建议用于STDIO)

无需安装!只需配置您的MCP客户端:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "weather-mcp-server"],
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

选项2:全局安装

npm install -g weather-mcp-server

然后配置:

{
  "mcpServers": {
    "weather": {
      "command": "weather-mcp",
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

选项3:SSE模式(远程服务器)

如果部署到服务器(例如Render、Railway):

{
  "mcpServers": {
    "weather": {
      "transport": "sse",
      "url": "https://your-server.com/sse?key=your_api_key"
    }
  }
}

可用工具

工具 说明
get-weather 获取城市的实时天气
get-forecast 获取5天天气预报

例子

问你的AI助手:

  • “东京的天气怎么样?”
  • “给我纽约的5天天气预报”
  • "北京今天天气怎么样?"
  • "上海未来三天天气预报"

自托管(SSE模式)

# Clone the repo
git clone https://github.com/your-username/weather-mcp-server
cd weather-mcp-server
npm install

# Start SSE server
npm run start:sse

# Or with custom port
PORT=8080 npm run start:sse

API密钥

从获取您的免费API密钥 开放天气.


中文

功能特点

  • 🌡️ 实时天气 - 获取任意城市的当前天气
  • 📅 5天预报 - 获取最多5天的天气预报
  • 🌍 双语支持 - 支持中英文城市名
  • 🔌 双传输模式 - 同时支持 STDIO 和 SSE 模式
  • 🔑 灵活认证 - 支持 URL、Header 或环境变量传递 API Key

安装使用

方式1: NPX 直接运行(推荐)

无需安装,直接配置 MCP 客户端:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "weather-mcp-server"],
      "env": {
        "OPENWEATHER_API_KEY": "你的API密钥"
      }
    }
  }
}

方式2: 全局安装

npm install -g weather-mcp-server

然后配置:

{
  "mcpServers": {
    "weather": {
      "command": "weather-mcp",
      "env": {
        "OPENWEATHER_API_KEY": "你的API密钥"
      }
    }
  }
}

方式3: SSE 远程服务

如果已部署到服务器:

{
  "mcpServers": {
    "weather": {
      "transport": "sse",
      "url": "https://your-server.com/sse?key=你的API密钥"
    }
  }
}

可用工具

工具 描述
get-weather 获取城市实时天气
get-forecast 获取5天天气预报

使用示例

向 AI 助手提问:

  • "东京现在天气怎么样?"
  • "帮我查一下纽约未来5天的天气"
  • "北京今天热不热?"
  • "深圳明天会下雨吗?"

获取 API Key

前往 开放天气 免费注册获取。


许可证

麻省 理工© 巨大350