MCPWeather

gwyer/MCPWeather

3.2

If you are the rightful owner of MCPWeather and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The MCP Weather Notes Server is a minimal Model Context Protocol server implemented in Python, providing weather data and note-taking functionalities.

Tools
3
Resources
0
Prompts
0

MCP Weather Notes Server

Python

A minimal Model Context Protocol (MCP) server in Python that exposes three tools:

Available Tools

  1. get_weather(city) – Returns current weather using Open-Meteo API

    • Input: city name (string)
    • Output: temperature, wind speed, weather code, etc.

  2. save_note(text) – Saves a note to local JSON file

    • Input: note text (string)
    • Output: saved note with ID and timestamp

  3. get_notes() – Retrieves all saved notes from local storage

    • Input: none
    • Output: array of all notes with IDs, text, and timestamps

Setup

See for instructions on connecting to Claude Desktop.

Testing

Run the test suite without an MCP client:

source .venv/bin/activate
python test_tools.py

Running the Server

Start the server directly (for testing):

source .venv/bin/activate
python server.py

Stop the server gracefully with Ctrl+C (only one press needed).

For more details on stopping the server, see .

Features

  • ✅ Real-time weather data from Open-Meteo API
  • ✅ Local JSON-based note storage
  • ✅ Retrieve all saved notes
  • ✅ Graceful shutdown handling
  • ✅ Comprehensive error handling
  • ✅ Full test suite included
  • ✅ Works with Claude Desktop and Claude Code

Requirements

  • Python 3.11+
  • Virtual environment (included)
  • MCP-compatible client (Claude Desktop or Claude Code)

Contributing

Contributions welcome! Feel free to:

  • Report bugs
  • Suggest new features
  • Submit pull requests

License

MIT License - see LICENSE file for details

Acknowledgments

Built with the Model Context Protocol by Anthropic.