HeFeng Weather

an mcp server for hefeng weather api

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shanggqm-hefeng-mcp-weather": {
      "command": "npx",
      "args": [
        "hefeng-mcp-weather@latest",
        "--apiKey=${API_KEY}"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can query real-time and forecast weather data for locations in China using the HeFeng Weather MCP Server. It exposes a lightweight weather tool that lets you fetch current conditions and multiple forecast horizons via the HeFeng Weather API, all through a simple MCP client integration.

How to use

You will use the built-in get-weather tool to request weather data for a specific location. Provide a latitude and longitude to get accurate results for the exact place you’re interested in. You can retrieve real-time conditions, hourly forecasts (24h, 72h, or 168h), and daily forecasts (3d, 7d, 10d, 15d, 30d). All responses come with a full Chinese weather description.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install and run the MCP server using the included NPX command snippet.

Install and run the MCP server with NPX

{
  "mcpServers": {
    "hefeng-weather": {
      "command": "npx",
      "args": ["hefeng-mcp-weather@latest", "--apiKey=${API_KEY}"]
    }
  }
}

Notes on configuration and usage

Replace ${API_KEY} with your HeFeng Weather API key. You can export it as an environment variable or substitute it directly in the command when you start the MCP.

Additional sections

Security: Treat your API key as a secret. Do not commit it to version control and restrict access to the MCP client where possible.

End user guidance

Once the server is running, your MCP client can call get-weather to fetch weather data for any location by providing coordinates. The tool returns both current conditions and forecasts in Chinese, suitable for display in your applications.

Available tools

get_weather

Get weather forecast data for a location by providing coordinates. Includes real-time data and multiple forecast horizons with full Chinese weather descriptions.