Skip to main content

weather-forecast-server: MCP server for weather forecast

Project description

MseeP.ai Security Assessment Badge

Weather Forecast MCP Server

A Model Context Protocol (MCP) server for retrieving weather information using the wttr.in service.

Overview

This MCP server provides tools for accessing current weather conditions and forecasts for locations worldwide. It can be easily integrated with MCP clients, including Claude and other LLM applications supporting the MCP protocol.

Features

  • Get current weather for any location
  • Get multi-day weather forecasts (up to 3 days)
  • Support for both Chinsee/English and other language location names
  • Easy integration with MCP client applications

Installation

From pip

You can install the MCP Weather Server using uv:

uv pip install weather-forecast-server

Or using pip:

pip install weather-forecast-server

From source

git clone https://github.com/shibing624/mcp-server-weather.git
cd weather-forecast-server
pip install -e .

Usage

Python Demo

from weather_forecast_server import get_weather
print(get_weather('baoding')) # can be "baoding" or "保定"

Running as a standalone MCP server

Run the server with the stdio transport:

uvx weather-forecast-server

or

uv run weather-forecast-server

or

python -m weather_forecast_server

Then, you can use the server with any MCP client that supports stdio transport.

Integrating with Cursor

To add the weather MCP server to Cursor, add stdio MCP with command:

uv run weather-forecast-server

Tools available

  • get_weather - Get current weather conditions for a location (up to 3 days)

Contact

  • Issues and suggestions: GitHub issues
  • Email: xuming624@qq.com
  • WeChat: Add me (WeChat ID: xuming624) with the message: "Name-Company-NLP" to join our NLP discussion group.

License

This project is licensed under The Apache License 2.0 and can be used freely for commercial purposes. Please include a link to the weather-forecast-server project and the license in your product description.

Contribute

We welcome contributions to improve this project! Before submitting a pull request, please:

  1. Add appropriate unit tests in the tests directory
  2. Run python -m pytest to ensure all tests pass
  3. Submit your PR with clear descriptions of the changes

Acknowledgements

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

weather_forecast_server-0.0.7.tar.gz (9.0 kB view details)

Uploaded Source

File details

Details for the file weather_forecast_server-0.0.7.tar.gz.

File metadata

  • Download URL: weather_forecast_server-0.0.7.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.5

File hashes

Hashes for weather_forecast_server-0.0.7.tar.gz
Algorithm Hash digest
SHA256 b1ed6971039ad9d82aa2f8b6dc7a5974e31d7b83ed30773e773c9906cf8e5cfd
MD5 449be8a1cd0fbc00a3baebbe92a69c99
BLAKE2b-256 5b15e416a9a243851739af78523bc4077e0ad11d0204f82e047d357605c76a9a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page