返回市场
开天气服务

开天气服务

作者:mschneider8213 星标更新:2025-08-07

项目介绍

MCP天气服务

一个简单的MCP服务,使用免费的OpenWeatherMap API提供当前天气和5天预报。

特性

  • 当前天气状况
  • 5天天气预报
  • 可配置单位(摄氏度/华氏度/开尔文)
  • 多语言支持
  • 简单的MCP集成

预备条件

  • Go 1.20+
  • OpenWeatherMap API密钥

安装

  1. https://openweathermap.org/api获取OpenWeatherMap API密钥

  2. 克隆仓库:

    git clone https://github.com/mschneider82/mcp-openweather.git
    cd mcp-openweather
    
  3. 构建:

    go build -o mcp-weather
    

配置

设置必需的环境变量:

export OWM_API_KEY="your_api_key_here"

使用方法


 "mcpServers": {
     "mcp-openweather": {
         "command": "/home/YOURUSER/git/mcp-openweather/mcp-openweather",
         "env": {
             "OWM_API_KEY": "PUT_API_KEY_HERE"
         }
     }
 }

MCP参数

 {
     "tool": "weather",
     "params": {
         "city": "Berlin",          // 必需
         "units": "c",             // 可选 (c|f|k)
         "lang": "en"              // 可选 (en|de|fr|...)
     }
 }

示例响应

 慕尼黑当前天气:
     条件:晴朗天空
     现在:17.78 度
     最高:18.66 度
     最低:17.36 度
     气压:1017
     湿度:40
     体感温度:16.66
     风速:1.79
     风向:61
     日出:1747107429 Unix时间
     日落:1747161784 Unix时间
 慕尼黑天气预报:
 日期与时间:2025-05-13 12:00:00 +0000 UTC
 条件:晴朗晴朗天空
 温度:17.78
 最高:18.93
 最低:17.78

 日期与时间:2025-05-13 15:00:00 +0000 UTC
 条件:晴朗晴朗天空
 温度:18.33
 最高:19.44
 最低:18.33

 日期与时间:2025-05-13 18:00:00 +0000 UTC
 条件:晴朗晴朗天空
 温度:16.32
 最高:16.32
 最低:15.59

 日期与时间:2025-05-13 21:00:00 +0000 UTC
 条件:晴朗晴朗天空
 温度:9.18
 最高:9.18
 最低:9.18
...

错误处理

常见错误场景:

缺少API密钥:FATAL: OWM_API_KEY环境变量未设置

无效城市:当前天气错误:无法获取当前天气:城市未找到

网络问题:无法获取预报:上下文超时

开发

欢迎贡献!请遵循以下步骤:

分叉仓库

创建功能分支

提交更改

推送到分支

创建拉取请求

许可证

MIT许可证 - 详情见LICENSE文件