MCP Weather Notes Server

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 SETUP_CLAUDE.md 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 STOPPING_SERVER.md.

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.