Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Mamiriro (MEGMIS)

von walter-kudzai-kamangaVersion 0.1.0i★ 1iComputer oder CloudRepository ↗
Name in der Registryio.github.walter-kudzai-kamanga/megmis

So installierst du es

Was es kann

PROTOTYPE: Zimbabwe weather, geo, safe routing & journey risk via REST+MCP (stdio/HTTP).

Originaltext des Herstellers

  • Verbindung Computer oder Cloud
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit4/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert24/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Mamiriro (MEGMIS). Folge https://mcp.popnx.com/i/walter-kudzai-kamanga-megmis.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (megmis-api.onrender.com) · ✓ Befehle geprüft am 16. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameMamiriro (MEGMIS)
    Remote MCP server URL · Adressehttps://megmis-api.onrender.com/mcp/

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsMamiriro (MEGMIS)

  4. Ausprobieren

    Nutze Mamiriro (MEGMIS) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Mamiriro (MEGMIS) nutzt, oder ein Werkzeug von Mamiriro (MEGMIS) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameMamiriro (MEGMIS)
    Connection · Adressehttps://megmis-api.onrender.com/mcp/
  3. Mamiriro (MEGMIS) im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Mamiriro (MEGMIS) aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Mamiriro (MEGMIS) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Mamiriro (MEGMIS) nutzt, oder ein Werkzeug von Mamiriro (MEGMIS) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user megmis https://megmis-api.onrender.com/mcp/
  3. /mcp in Claude Code eingeben

    Mamiriro (MEGMIS) sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Mamiriro (MEGMIS) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Mamiriro (MEGMIS) nutzt, oder ein Werkzeug von Mamiriro (MEGMIS) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Mamiriro (MEGMIS) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Mamiriro (MEGMIS) nutzt, oder ein Werkzeug von Mamiriro (MEGMIS) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Mamiriro (MEGMIS) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Mamiriro (MEGMIS) nutzt, oder ein Werkzeug von Mamiriro (MEGMIS) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://megmis-api.onrender.com/mcp/

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Mamiriro (MEGMIS) nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user megmis https://megmis-api.onrender.com/mcp/

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "megmis": {
      "url": "https://megmis-api.onrender.com/mcp/"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "megmis": {
      "type": "http",
      "url": "https://megmis-api.onrender.com/mcp/"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user megmis -- uvx megmis

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "megmis": {
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "megmis": {
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "megmis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

Werte, die du selbst einträgst

  • DEV_API_KEY geheim env
    API-Schlüssel für schreibende Tools und die Mandantendaten-Speicherung (optional für schreibgeschützte Demos).
    Englisches Original anzeigenAPI key for mutating tools / tenant persistence (optional for read-only demos).
  • USE_PERSISTENCE env
    Auf false setzen für lokales stdio im Arbeitsspeicher ohne Postgres/Redis.
    Englisches Original anzeigenSet false for in-memory local stdio without Postgres/Redis.
  • GEOCODE_PROVIDER env
    Geocoding-Adapter: mock nominatim
    Englisches Original anzeigenGeocoding adapter: mock | nominatim
  • WEATHER_PROVIDER env
    Wetter-Adapter: mock open-meteo openweather
    Englisches Original anzeigenWeather adapter: mock | open-meteo | openweather
  • ROUTING_PROVIDER env
    Routing-Adapter: mock osrm valhalla graphhopper
    Englisches Original anzeigenRouting adapter: mock | osrm | valhalla | graphhopper

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.0
In der Registry veröffentlichti
16. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
16. Nov. 2026
Entwickler
walter-kudzai-kamanga
Pakete
pypi: megmis
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 16. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • get_current_weather

    Current weather for a location ({lat,lon} or {name}).

  • get_forecast

    Daily forecast (1-14 days).

  • get_hourly_forecast

    Hourly forecast for a specific ISO date (YYYY-MM-DD).

  • get_weather_alerts

    Active weather alerts; official warnings labelled separately from model-derived.

  • compare_weather

    Compare current weather across multiple locations.

  • get_historical_weather

    Historical weather observations between ISO dates.

  • get_air_quality

    Air quality index and pollutants for a location.

  • get_agricultural_conditions

    Agricultural / growing-condition indicators.

  • analyze_weather_risk

    Activity-based weather risk (e.g. outdoor_wedding) with recommendations.

  • recommend_outdoor_activities

    Suitability scores for common outdoor activities.

  • geocode

    Geocode an address or place name to coordinates.

  • reverse_geocode

    Reverse-geocode coordinates to an address.

  • find_nearby_places

    Find nearby places by optional category within radius_m.

  • get_emergency_facilities

    Nearby emergency facilities (hospital, police, fire).

  • optimize_route

    Ranked routes with cost_breakdown and explanation (shortest is not always best).

  • create_journey

    Create an active journey from a route_id returned by optimize_route (requires auth).

  • reroute

    Recompute alternatives for an active journey (requires auth).

  • get_route_conditions

    Weather, traffic and road-condition summary for a route or corridor.

  • report_road_condition

    Submit a crowdsourced road-condition report (requires auth + road:write).

  • get_road_incidents

    List road incidents for an area or corridor.

  • assess_journey_risk

    Composite journey risk from weather + routing + road; persists when tenant is known. Tenant resolution order: explicit api_key arg → request ContextVar (X-API-Key on /mcp) → default demo tenant when persistence is on.

  • get_traffic_congestion

    Traffic sub-module congestion estimate for a corridor.

  • list_service_packs

    List Insurance / GovTech commercial service packs (Gen 4).

  • run_service_pack

    Run a commercial pack: insurance.corridor | govtech.emergency | govtech.mobility.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto walter-kudzai-kamanga bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 134 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 24 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für megmis@0.1.0

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 16. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/walter-kudzai-kamanga-megmis.svg)](https://mcp.popnx.com/en/servers/walter-kudzai-kamanga-megmis)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 88 % der anderen 2052 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 87 % der anderen 2052 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2052 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Mamiriro (MEGMIS) sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.0) kam vor 4 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

von microWachsend★ 441Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 15Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 13 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
Mamiriro (MEGMIS)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen5/54/43/33/34/44/4
LizenzMITAGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Mamiriro (MEGMIS)

Mamiriro Environmental, Geospatial & Mobility Intelligence Server — weather, geospatial, explained routing, road conditions, and journey-risk intelligence for Zimbabwe corridors (and beyond), exposed as REST and MCP (stdio + Streamable HTTP).

Python 3.12 · FastAPI · PostGIS · Redis · official MCP Python SDK

SurfaceEndpoint
REST APIhttp://127.0.0.1:8000/api/v1/...
OpenAPI / docshttp://127.0.0.1:8000/docs
MCP (HTTP)http://127.0.0.1:8000/mcp/
MCP (stdio)megmis-mcp / python -m megmis.mcp_stdio
HealthGET /healthz
Voice Lab (optional)http://127.0.0.1:8000/voice/
Console (optional)http://127.0.0.1:8088/

Status: MIT-licensed public prototype (v0.1.0) — local mocks by default; live providers optional via env. Not a paid SLA or production weather/routing product yet. Listings must say prototype / mock providers.

Naming: Mamiriro is the product; MEGMIS is the project acronym (Environmental, Geospatial & Mobility Intelligence Server); `megmis` is the PyPI / CLI package.

Public surfaceURL
PyPIhttps://pypi.org/project/megmis/
Hosted API / MCPhttps://megmis-api.onrender.com
MCP Streamable HTTPhttps://megmis-api.onrender.com/mcp/
Server cardhttps://megmis-api.onrender.com/.well-known/mcp.json
AI cataloghttps://megmis-api.onrender.com/.well-known/ai-catalog.json

Engineering docs live under docs/.


What it does

  • Weather — current, forecast, hourly, alerts, historical, air quality, ag conditions, activity risk
  • Geo — geocode, reverse geocode, nearby places, emergency facilities
  • Routing — multi-criteria optimize_route with cost breakdown (safest / fastest / …), reroute, corridor conditions, traffic
  • Roads — incident reporting & crowdsourced condition pipeline
  • Risk — journey risk assessment (REST + MCP)
  • Platform — API keys, webhooks (HMAC), tenant RLS, rate limits, worker jobs
  • Voice (Gen 3) — Whisper STT + edge-tts, agent sessions, WebSocket + Voice Lab
  • Commercial (Gen 4) — provider failover, Insurance/GovTech packs, GPS cost calibration, object-store retention, /metrics

Providers are swappable with health-gated failover (mock by default; Open-Meteo / OpenWeather, Valhalla / GraphHopper / OSRM via env). Open-Meteo free API is non-commercial — see OPEN_METEO_COMMERCIAL_OK.


Requirements

  • Python 3.12+
  • Docker (recommended for PostGIS + Redis)
  • Optional: [voice] extras for Whisper / TTS

Install (PyPI / local package)

Once published (or from a built wheel):

pip install megmis

optional voice extras: pip install "megmis[voice]"

stdio MCP for Cursor / Claude / VS Code / Windsurf

USE_PERSISTENCE=false megmis-mcp

or one-shot without a permanent install:

uvx --from megmis megmis-mcp

Build locally without uploading:

pip install -e ".[dev]"

python -m build twine check dist/*

Release to PyPI: push a v* tag after configuring Trusted Publishing (see .github/workflows/release.yml).


Quick start

1. API only (in-memory / no Docker)
python3 -m venv .venv && source .venv/bin/activate

pip install -e ".[dev]" cp .env.example .env

USE_PERSISTENCE=false # optional for offline unit work

uvicorn megmis.main:app --reload --host 0.0.0.0 --port 8000

or: megmis-api

2. Full stack (PostGIS + Redis)

Postgres is published on host 5433 (avoids clashing with a local 5432).

docker compose up --build -d postgres redis

cp .env.example .env

export DATABASE_URL=postgresql+psycopg://megmis:megmis@localhost:5433/megmis export REDIS_URL=redis://localhost:6379/0 export USE_PERSISTENCE=true

alembic upgrade head python scripts/seed.py uvicorn megmis.main:app --reload --port 8000

All-in-one (API + DB + Redis + worker wiring):

docker compose up --build
Dev API keys
X-API-Key: meg_local_devkey00000000000000000001   # demo tenant

X-API-Key: meg_local_tenantb00000000000000000002 # tenant-b (isolation tests)

Auth
  • REST and MCP HTTP: send X-API-Key: meg_… on every request (hashed at rest; scopes enforced).
  • MCP stdio: seeds the demo tenant from DEV_API_KEY / settings (no header needed locally).
  • Mutating MCP tools also accept an api_key argument when no HTTP context is present.
  • OAuth / OIDC for remote connectors is planned for commercial hosting — not required for local stdio.
  • Details: docs/engineering/security-and-tenancy.md.

REST examples

export DEV_API_KEY=meg_local_devkey00000000000000000001

curl -s -H "X-API-Key: $DEV_API_KEY" \ "http://127.0.0.1:8000/api/v1/weather/current?name=Harare" | jq

curl -s -H "X-API-Key: $DEV_API_KEY" -H "Content-Type: application/json" \ -d '{"origin":{"name":"Harare"},"destination":{"name":"Bulawayo"},"profile":"safest"}' \ http://127.0.0.1:8000/api/v1/routes/optimize | jq

Gen 4 commercial pack + provider health

curl -s -H "X-API-Key: $DEV_API_KEY" http://127.0.0.1:8000/api/v1/packs | jq curl -s -H "X-API-Key: $DEV_API_KEY" http://127.0.0.1:8000/api/v1/ops/providers | jq curl -s http://127.0.0.1:8000/metrics | head

Interactive docs: http://127.0.0.1:8000/docs. Contract: docs/api/openapi.yaml (v0.4.0). Gen 4 ops notes: docs/operations/gen4-commercial.md.


MCP

Same tools as REST (weather, geo, routing, roads, journey risk, traffic), plus create_journey. Contracts: docs/api/mcp-tool-contracts.md.

Mutating tools (report_road_condition, create_journey, reroute) require X-API-Key on HTTP /mcp, or an api_key argument. Stdio seeds the demo tenant automatically.

TransportHow
Streamable HTTPhttp://127.0.0.1:8000/mcp/ (same process as the API)
stdiomegmis-mcp or python -m megmis.mcp_stdio
Cursor / Claude Desktop (stdio)

After pip install -e . (or a published megmis wheel), point the client at the console script or module:

{

"mcpServers": { "mamiriro": { "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Editable checkout (absolute venv path):

{

"mcpServers": { "mamiriro": { "command": "/ABS/PATH/TO/.venv/bin/python", "args": ["-m", "megmis.mcp_stdio"], "cwd": "/ABS/PATH/TO/megmis" } } }

VS Code (MCP extension / mcp.json)
{

"servers": { "mamiriro": { "type": "stdio", "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Windsurf

Same stdio shape as Cursor — add under MCP servers:

{

"mcpServers": { "mamiriro": { "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Claude Code

Stdio (after pip install megmis or uvx):

claude mcp add mamiriro --env USE_PERSISTENCE=false -- megmis-mcp

Or remote HTTP (when the CLI supports URL transports):

https://megmis-api.onrender.com/mcp/
Remote / HTTP clients

Local API (uvicorn or Docker):

http://127.0.0.1:8000/mcp/

Hosted prototype (Render):

https://megmis-api.onrender.com/mcp/

Pass X-API-Key the way your client supports custom headers (or use tool api_key on mutating calls). Cursor-style remote entry:

{

"mcpServers": { "mamiriro-http": { "url": "https://megmis-api.onrender.com/mcp/", "headers": { "X-API-Key": "YOUR_RENDER_DEV_API_KEY" } } } }

Local override while developing:

{

"mcpServers": { "mamiriro-http-local": { "url": "http://127.0.0.1:8000/mcp/", "headers": { "X-API-Key": "meg_local_devkey00000000000000000001" } } } }

ChatGPT (Connectors / custom MCP)
  1. Use a ChatGPT plan that supports custom MCP / connectors.
  2. Add a connector pointing at Streamable HTTP: https://megmis-api.onrender.com/mcp/
  3. Send auth as X-API-Key: if the UI exposes custom headers (mutating tools require it).
  4. Label the connector prototype / mock providers until live adapters are the default.

Discovery without a directory: open https://megmis-api.onrender.com/.well-known/mcp.json.

Example prompts
  • Plan the safest Harare → Bulawayo drive and explain the cost breakdown.
  • Assess weather risk for outdoor work in Mutare tomorrow.
  • List road incidents on the Harare–Bulawayo corridor.
  • Assess journey risk from Harare to Bulawayo for a light truck.

Configuration

Copy .env.example → .env. Important knobs:

VariablePurpose
USE_PERSISTENCEtrue → PostGIS + Redis; false → memory fallback
DATABASE_URL / DATABASE_APP_URLOwner vs RLS app role (megmis_app)
USE_APP_ROLEEnforce tenant RLS via app role
WEATHER_PROVIDERmock \open-meteo \openweather
ROUTING_PROVIDERmock \valhalla \graphhopper \osrm
GEOCODE_PROVIDERmock \nominatim
SPEECH_PROVIDER / TTS_PROVIDERwhisper / edge (voice extras)
OSM_EXTRACT_PATHCorridor graph for local Dijkstra

OSM seed extract: data/osm/zimbabwe-harare-bulawayo.osm Optional full country PBF: ./scripts/download_osm_extract.sh


Worker & console

docker compose up -d worker

docker compose --profile console up -d console # http://127.0.0.1:8088/

or locally

megmis-worker # or: python -m megmis.worker python -m megmis.console_app

Worker drains webhooks, validates road reports, fan-outs alerts, and marks OSM graph refresh.


Voice Lab (optional)

pip install -e ".[voice]"

SPEECH_PROVIDER=whisper WHISPER_MODEL=base TTS_PROVIDER=edge

uvicorn megmis.main:app --reload --port 8000

open http://127.0.0.1:8000/voice/

  • STT: OpenAI Whisper via faster-whisper (falls back to mock if deps missing)
  • TTS: edge-tts (ZA English; Shona/Ndebele localized reply text)
  • Scenario: POST /api/v1/agents/scenarios/mutare
  • WebSocket: ws://127.0.0.1:8000/ws/voice/{session_id}?api_key=...

Tests

# unit + contract + BDD + tenant isolation (no Docker)

USE_PERSISTENCE=false pytest -q -m "not integration"

integration (PostGIS + Redis required)

INTEGRATION=1 USE_PERSISTENCE=true pytest -q -m integration

Gen 2 platform + provider HTTP mocks

INTEGRATION=1 USE_PERSISTENCE=true USE_APP_ROLE=true \ pytest -q tests/test_gen2_platform.py tests/test_providers_http.py

deep smokes (API must be running)

python scripts/gen1_deep_smoke.py python scripts/gen2_deep_smoke.py python scripts/gen12_deep_smoke.py

CI: .github/workflows/ci.yml. Strategy: docs/quality/test-strategy.md.


Publish & discovery

Playbook: docs/operations/mcp-publish-and-discover.md

PhaseStatus
0 Pre-flightDone
2 PyPI package + Trusted Publishing workflowDone (upload on first v* tag after PyPI pending publisher)
3 Deploy HTTPS /mcpLive: https://megmis-api.onrender.com (/mcp/)
4 Official MCP Registry (server.json)Manifest ready; publish after PyPI
6+ Directories / GEOAfter registry
Hosted MCP (Phase 3)
# fastest: Render Blueprint (render.yaml) or: fly deploy

then:

./scripts/verify_remote_mcp.sh https://YOURHOST

Set `PUBLIC_BAS

Nur der Anfang wird gezeigt; den Rest findest du im Repo