mcpField
W
Weather MCP Server

Weather MCP Server

本地服务
github.com/CodeByWaqas媒体与设计582 周前更新

关于 Weather MCP Server

Weather MCP Server 通过 OpenWeatherMap API 提供实时天气信息,供 MCP 客户端查询。它返回温度、湿度、风速、日出日落时间和天气描述,温度使用公制单位。

主要功能

  1. 01实时天气查询
  2. 02公制温度数据
  3. 03湿度与风速信息
  4. 04日出日落时间
  5. 05天气状况描述

适用场景

  1. 01在对话中查询当前天气
  2. 02查看指定查询的温度和湿度
  3. 03获取风速及日出日落信息

MCP 相关

该 MCP 服务将 OpenWeatherMap 天气数据提供给 MCP 客户端。使用时需配置 OpenWeatherMap API 密钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"weather-mcp-server-codebywaqas": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Weather MCP Server

smithery 徽章

一个基于 OpenWeatherMap API 提供天气信息的现代代码协议(MCP)服务。

功能

  • 实时获取天气数据
  • 使用公制温度单位
  • 提供详细天气信息,包括:
    • 温度
    • 湿度
    • 风速
    • 日出/日落时间
    • 天气描述

前提条件

  • Python 3.12 或更高版本
  • OpenWeatherMap API 密钥

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Weather MCP Server:

npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude
手动安装
  1. 克隆仓库
  2. 创建虚拟环境:
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
  1. 安装依赖:
pip install -e .

设置说明

使用 Claude Desktop 设置
# claude_desktop_config.json
# Can find location through:
# Claude -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
      "mcp-weather-project": {
          "command": "uv",
          "args": [
              "--directory",
              "/<absolute-path>/weather-mcp-server/src/resources",
              "run",
              "server.py"
          ],
          "env": {
            "WEATHER_API_KEY": "YOUR_API_KEY"
          }
      }
  }
}

本地/开发环境设置说明

克隆仓库

git clone https://github.com/CodeByWaqas/weather-mcp-server

安装依赖

安装 MCP 服务依赖:

cd weather-mcp-server

# Create virtual environment and activate it
uv venv

source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# Install dependencies
uv add "mcp[cli]" python-dotenv requests httpx

配置

  1. 将 src/resources/env.example 复制到 src/resources/.env
  2. 将你的 OpenWeatherMap API 密钥添加到 .env 文件中:
WEATHER_API_KEY=your_api_key_here

使用方法

运行 Claude Desktop,并使用大模型获取天气信息

许可证

本项目采用 MIT License 许可,详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。