プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Mamiriro (MEGMIS)

作者:walter-kudzai-kamangaバージョン 0.1.0i★ 1iパソコンでもクラウドでもリポジトリ ↗
レジストリ名io.github.walter-kudzai-kamanga/megmis

インストール方法

できること

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

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー キー不要
  • カテゴリ 旅行・地図・天気

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア24/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Mamiriro (MEGMIS) をインストールして。https://mcp.popnx.com/i/walter-kudzai-kamanga-megmis.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(megmis-api.onrender.com)を通ります · ✓ コマンド確認済み 2026年11月16日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Mamiriro (MEGMIS)
    Remote MCP server URL · アドレスhttps://megmis-api.onrender.com/mcp/

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsMamiriro (MEGMIS)

  4. 試してみる

    Mamiriro (MEGMIS) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Mamiriro (MEGMIS) を使っていると言うか、回答に Mamiriro (MEGMIS) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Mamiriro (MEGMIS)
    Connection · アドレスhttps://megmis-api.onrender.com/mcp/
  3. チャットで Mamiriro (MEGMIS) を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Mamiriro (MEGMIS) を選びます

  4. 試してみる

    Mamiriro (MEGMIS) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Mamiriro (MEGMIS) を使っていると言うか、回答に Mamiriro (MEGMIS) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user megmis https://megmis-api.onrender.com/mcp/
  3. Claude Code で /mcp と入力

    Mamiriro (MEGMIS) が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Mamiriro (MEGMIS) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Mamiriro (MEGMIS) を使っていると言うか、回答に Mamiriro (MEGMIS) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Mamiriro (MEGMIS) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Mamiriro (MEGMIS) を使っていると言うか、回答に Mamiriro (MEGMIS) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Mamiriro (MEGMIS) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Mamiriro (MEGMIS) を使っていると言うか、回答に Mamiriro (MEGMIS) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://megmis-api.onrender.com/mcp/

JSON 設定は下の「開発者向け」にあります

つまずいたら?Mamiriro (MEGMIS) を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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/"
    }
  }
}

パソコンにインストール

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"
      ]
    }
  }
}

自分で入力する値

  • DEV_API_KEY 秘密 env
    変更系ツール/テナントデータの永続化用の API キー(読み取り専用のデモでは任意)。
    英語の原文を見るAPI key for mutating tools / tenant persistence (optional for read-only demos).
  • USE_PERSISTENCE env
    Postgres/Redis を使用しない、ローカルのインメモリ stdio の場合は false に設定します。
    英語の原文を見るSet false for in-memory local stdio without Postgres/Redis.
  • GEOCODE_PROVIDER env
    ジオコーディングアダプター: mock nominatim
    英語の原文を見るGeocoding adapter: mock | nominatim
  • WEATHER_PROVIDER env
    天気アダプター:mock open-meteo openweather
    英語の原文を見るWeather adapter: mock | open-meteo | openweather
  • ROUTING_PROVIDER env
    ルーティングアダプター: mock osrm valhalla graphhopper
    英語の原文を見るRouting adapter: mock | osrm | valhalla | graphhopper

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンでもクラウドでも
トランスポート
stdio, streamable-http
最新バージョンi
0.1.0
レジストリ公開日i
2026年11月16日
コードの最終更新i
2026年11月19日
最終確認
2026年11月16日
作者
walter-kudzai-kamanga
パッケージ
pypi: megmis
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月16日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント walter-kudzai-kamanga で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    134ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    24件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

OSV.dev に megmis@0.1.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

旅行・地図・天気のほかのサーバーとの比較i

  • このカテゴリのほかの2052件のうち88%よりスターが多い
  • このカテゴリのほかの2052件のうち87%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2052件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Mamiriro (MEGMIS)は安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.1.0)がレジストリに届いたのは4 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Mu

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

作者:micro成長中★ 4414 か月前更新

クラウドで動く✓ micro.mu

Whimsical

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

作者:WhimsicalCode初期★ 112 か月前更新

クラウドで動く✓ 提供元 · whimsical.com
似たものと比べる
これ
Mamiriro (MEGMIS)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえはい
基本チェック5/54/43/33/34/44/4
ライセンスMITAGPL-3.0MITMITMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます