返回 MCP 目录
public公开dns本地运行

qweather-mcp

qweather-mcp是一个为QWeather API提供天气查询功能的MCP服务器项目,支持通过命令行或配置文件快速部署,提供城市查询和实时天气获取功能。

article

README

🚀 qweather-mcp

本项目是为QWeather API提供服务的MCP服务器,借助Model Context Protocol (MCP) 实现天气信息的查询功能。

🚀 快速开始

在开始使用本项目前,您需要先在这里获取API密钥。

📦 安装指南

通过Smithery安装

若要为Claude Desktop自动安装qweather-mcp插件,可使用Smithery,执行以下命令:

npx -y @smithery/cli install @overstarry/qweather-mcp --client claude

手动配置

执行以下命令启动标准输入输出服务器:

# 标准输入输出服务器
npx -y qweather-mcp

同时,您需要设置以下环境变量:

QWEATHER_API_BASE=https://api.qweather.com
QWEATHER_API_KEY=<您的API密钥>

JSON配置

您也可以使用JSON文件进行配置,示例如下:

{
  "mcpServers": {
    "qweather": {
      "command": "npx",
      "args": ["-y", "qweather-mcp"],
      "env": {
        "QWEATHER_API_BASE": "<您的API地址>",
        "QWEATHER_API_KEY": "<您的API密钥>"
      }
    }
  }
}

💻 使用示例

可用工具

  • lookup-city:根据名称查找城市信息
  • get-weather-now:获取指定位置的当前天气状况

📄 许可证

本项目采用MIT许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端