Weather Server

v1.0.0Search & Data Extractionstable

一个基于和风天气构造的天气服务MCP,支持SSE

weathermcpservermcpai-integration
Share:
19
Stars
0
Downloads
0
Weekly
0/5

What is Weather Server?

Weather Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 一个基于和风天气构造的天气服务mcp,支持sse

一个基于和风天气构造的天气服务MCP,支持SSE

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 一个基于和风天气构造的天气服务MCP,支持SSE

Use Cases

Get weather forecasts and data
Cooosin

Maintainer

LicenseMIT
Languagejava
Versionv1.0.0
UpdatedFeb 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx weathermcpserver

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Weather Server

WeatherMcpServer is a Java-based MCP server that provides real-time weather data by connecting to the QWeather (和风天气) service, with support for Server-Sent Events (SSE) for streaming weather updates to AI clients. It enables AI assistants to fetch current conditions, forecasts, and meteorological data for locations in China and globally through the QWeather API. Developers building weather-aware AI applications or integrating weather data into local Chinese-language deployments will find this server particularly useful for its SSE streaming capability.

Prerequisites

  • Java 11 or later installed
  • Maven build tool installed
  • A QWeather API key (free tier available at dev.qweather.com)
  • An MCP-compatible client that supports SSE connections
  • Git installed for cloning the repository
1

Clone the repository

Clone the WeatherMcpServer repository from GitHub.

git clone https://github.com/Cooosin/WeatherMcpServer
cd WeatherMcpServer
2

Obtain a QWeather API key

Register at dev.qweather.com (和风天气开发者平台) to get a free API key. The key is required for all weather data requests.

3

Configure the API key

Edit the application configuration file to set your QWeather API key as the value for hefeng.api.key.

# In src/main/resources/application.properties or application.yml:
hefeng.api.key=YOUR_QWEATHER_API_KEY
4

Build the project with Maven

Use Maven to compile and package the Java server.

mvn clean package -DskipTests
5

Run the server

Start the MCP server using the compiled JAR file.

java -jar target/WeatherMcpServer-*.jar
6

Configure your MCP client for SSE

Add the WeatherMcpServer to your MCP client configuration using the SSE transport pointing to your running server.

{
  "mcpServers": {
    "weather": {
      "url": "http://localhost:8080/sse",
      "transport": "sse"
    }
  }
}

Weather Server Examples

Client configuration

SSE-based MCP client configuration for connecting to a locally running WeatherMcpServer instance.

{
  "mcpServers": {
    "weather": {
      "url": "http://localhost:8080/sse",
      "transport": "sse"
    }
  }
}

Prompts to try

Sample prompts for retrieving weather data through the QWeather-backed server.

- "What is the current weather in Beijing?"
- "Get the 7-day weather forecast for Shanghai"
- "What is the air quality index in Shenzhen today?"
- "Show me the hourly forecast for Chengdu for the next 24 hours"
- "What is the temperature and humidity in Guangzhou right now?"

Troubleshooting Weather Server

Server starts but returns authentication errors from QWeather

Verify that hefeng.api.key in your configuration file matches the API key shown in your QWeather developer dashboard. Free tier keys have request limits — check your usage in the console.

Maven build fails with dependency resolution errors

Ensure you have a stable internet connection for Maven to download dependencies. If behind a corporate proxy, configure Maven's settings.xml with the proxy settings. Run 'mvn dependency:resolve' to diagnose missing artifacts.

MCP client cannot connect via SSE

Confirm the server is running and listening on the expected port (default 8080). Check that your MCP client supports SSE transport — some clients only support stdio. If there is a firewall, ensure port 8080 is accessible.

Frequently Asked Questions about Weather Server

What is Weather Server?

Weather Server is a Model Context Protocol (MCP) server that 一个基于和风天气构造的天气服务mcp,支持sse It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Weather Server?

Follow the installation instructions on the Weather Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Weather Server?

Weather Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Weather Server free to use?

Yes, Weather Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "weathermcpserver": { "command": "npx", "args": ["-y", "weathermcpserver"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Weather Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides