Weather

MCP Weather Notes Server - A minimal Model Context Protocol server with weather API and note-taking capabilities

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "gwyer-mcpweather": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You run a lightweight MCP server in Python that exposes weather data retrieval and simple local note storage. It’s useful for quick integrations with MCP clients and for testing tool chains that rely on a minimal, self-contained server.

How to use

You connect to the MCP server from your MCP client by referencing the available tools it exposes. This server provides three capabilities: get_weather(city) to fetch current weather data for a city, save_note(text) to store a note locally, and get_notes() to retrieve all saved notes. Use these tools through your client’s standard MCP invocation flow, calling each tool by name and providing the required inputs.

How to install

Prerequisites: you need Python 3.11 or newer. A virtual environment is provided as part of the setup.

Prepare and run the server locally with the following steps.

# Create and activate a virtual environment (if not already present)
python -m venv .venv
source .venv/bin/activate

# Start the MCP server
python server.py
```}]}]},{

Testing and running notes

You can verify the tooling works by running the provided test suite and then starting the server for manual testing.

source .venv/bin/activate
python test_tools.py

source .venv/bin/activate
python server.py

Stop the server gracefully with Ctrl+C when you’re finished.


## Available tools

### get\_weather

Fetches current weather data for a given city using the server’s weather tool.

### save\_note

Stores a text note locally and returns an identifier with a timestamp.

### get\_notes

Retrieves all saved notes, including IDs, text, and timestamps.