MVG Störung

MCP für Störungen der MVG (inoffiziell)

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": {
    "rmoriz-mvg_stoerung_mcp": {
      "command": "python",
      "args": [
        "mvg_mcp_server.py"
      ]
    }
  }
}

You run an MCP (Model Context Protocol) server that provides cached access to MVG disruption data. It fetches real-time MVG incidents, caches them to reduce API calls, and presents the information in a structured, MCP-friendly way so clients can quickly display current disruptions and search by line, title, or description.

How to use

You operate or integrate with the MVG Störung MCP Server to retrieve current MVG disruption data. Use the server through an MCP client to fetch current incidents, check the cache status, and perform targeted searches by line, title, or description. The server reports incidents with human readable timestamps and formatted descriptions to simplify display in your applications.

How to install

Prerequisites: Install Python and access to the internet to fetch dependencies.

pip install -r requirements.txt

python mvg_mcp_server.py

Configuration and usage notes

Key behavior to know: the server caches MVG incidents for at least 10 minutes to minimize API calls. You can force a refresh via the client if you need up-to-date data sooner. Incidents include a title, description, type (always INCIDENT), publication timestamps, validity windows, affected lines, and provider (MVG). The data source is the MVG API endpoint at https://www.mvg.de/api/bgw-pt/v3/messages. Filtering ensures only incidents are returned and the information is enhanced for easier consumption.

To start using the MCP server, run the following command in your environment where the server script is located: the server runs as a local process and serves MCP requests to your clients.

Available tools

get_mvg_incidents

Fetches current MVG incidents, using a 10+ minute cache to minimize API calls. Optional force_refresh parameter forces a cache refresh.

get_cache_status

Returns information about the cache status, including expiration and item count.

search_incidents

Search incidents by line, title, or description. Optional line filter narrows results to a specific MVG line.