qweather-mcp

qweather-mcp

site icon
2025.04.05 0
TypeScript天气查询位置服务位置服务
qweather-mcp 是一个基于 Model Context Protocol (MCP) 的天气信息查询服务,通过与 QWeather API 的集成,提供城市信息查询和实时天气数据获取功能。
View on GitHub

Overview

基本能力

产品定位

qweather-mcp 是一个天气信息查询服务,旨在通过 MCP 协议提供便捷的天气数据访问能力。

核心功能

  • 通过 QWeather API 查询天气信息
  • 提供城市信息查询功能
  • 获取指定位置的实时天气数据

适用场景

  • 需要集成天气信息的应用程序
  • 基于位置的天气查询服务
  • 天气数据分析和展示

工具列表

  • lookup-city: 通过城市名称查询城市信息
  • get-weather-now: 获取指定位置的当前天气数据

常见问题解答

  • 需要获取 QWeather API Key 才能使用服务
  • 可通过环境变量或 JSON 配置文件进行配置

使用教程

使用依赖

需要安装 Node.js 和 npm 环境

安装教程

  1. 通过 Smithery 自动安装:
npx -y @smithery/cli install @overstarry/qweather-mcp --client claude
  1. 手动配置:
npx -y qweather-mcp

环境变量配置

QWEATHER_API_BASE=https://api.qweather.com
QWEATHER_API_KEY=<your-api-key>

JSON 配置示例

{
  "mcpServers": {
    "qweather": {
      "command": "npx",
      "args": ["-y", "qweather-mcp"],
      "env": {
        "QWEATHER_API_BASE": "<your-api-url>",
        "QWEATHER_API_KEY": "<your-api-key>"
      }
    }
  }
}

调试方式

  1. 确保环境变量或配置文件正确设置
  2. 运行服务后,使用提供的工具进行测试
  3. 检查 API 响应是否正确

许可证

该项目遵循 MIT 开源许可条款。