原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 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 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 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) 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Mamiriro (MEGMIS),或回答中出现 Mamiriro (MEGMIS) 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 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) 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 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) 在列表中并显示已连接

  4. 试一试

    用 Mamiriro (MEGMIS) 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Mamiriro (MEGMIS),或回答中出现 Mamiriro (MEGMIS) 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Mamiriro (MEGMIS) 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Mamiriro (MEGMIS),或回答中出现 Mamiriro (MEGMIS) 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Mamiriro (MEGMIS) 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Mamiriro (MEGMIS),或回答中出现 Mamiriro (MEGMIS) 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

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

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Mamiriro (MEGMIS) 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

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
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 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天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Mu

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

作者:micro正在增长★ 4414个月前更新

在云端运行✓ micro.mu

Killbottleneck

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

作者:tengolabs起步阶段↓ 328/周★ 1413天前更新

在你的电脑上运行✓ 服务方 · killbottleneck.com

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

只显示了开头部分;其余内容请在仓库中阅读