MCP Weather Notes Server
A minimal Model Context Protocol (MCP) server in Python that exposes three tools:
Available Tools
get_weather(city) – Returns current weather using Open-Meteo API
Input: city name (string)
Output: temperature, wind speed, weather code, etc.
save_note(text) – Saves a note to local JSON file
Input: note text (string)
Output: saved note with ID and timestamp
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:
Running the Server
Start the server directly (for testing):
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.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides real-time weather data from Open-Meteo API and enables creating and retrieving notes stored locally in JSON format.