Map Canvas MCP

Ein eingebetteter interaktiver Kartendienst für MCP-App-Hosts wie ChatGPT. Der Worker gibt Kartendaten sowie einen stabilen UI-Loader zurück. Jedes Tool-Ergebnis wählt ein content-adressiertes Leaflet-Bundle aus, das über Cloudflare Static Assets ausgeliefert wird, sodass UI-Updates keine Aktualisierung unveränderter Tool-Metadaten erfordern. Der Browser des Nutzers lädt sichtbare OpenStreetMap-Kacheln direkt von den Standard-Kachelservern.

Produktions-Endpunkt

https://map-canvas.android-mxdiego9.workers.dev/mcp

Der Endpunkt ist öffentlich und erfordert keine Authentifizierung.

Related MCP server: Mapbox MCP Server

Lokale Entwicklung

npm install
npm run check
npm run dev

npm run check führt eine Typprüfung des Workers durch und führt MCP-Smoke-Tests für Initialisierung, Tool-Erkennung, Tool-Ausführung und Widget-Ressourcenladen aus.

Der lokale MCP-Endpunkt ist http://localhost:8787/mcp. Testen Sie ihn mit dem MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Bereitstellung

Bereitstellung über das Terminal:

npm run deploy

Es ist kein API-Schlüssel erforderlich. Fügen Sie keine Geheimnisse zum Quellcode oder zu wrangler.jsonc hinzu; verwenden Sie Cloudflare-Secrets, falls später eine Authentifizierung hinzugefügt wird.

Bereitstellung mit GitHub Actions

Der enthaltene Workflow stellt bei jedem Push auf main bereit und führt anschließend den Produktions-MCP-Smoke-Test gegen den öffentlichen Endpunkt aus. Er kann auch manuell über den Actions-Tab ausgeführt werden. Fügen Sie zuerst diese Repository-Actions-Secrets hinzu:

• CLOUDFLARE_API_TOKEN: ein Token, das zum Bearbeiten von Workern im Zielkonto berechtigt ist

• CLOUDFLARE_ACCOUNT_ID: die Ziel-Cloudflare-Konto-ID

Die Werte bleiben in den GitHub-Actions-Secrets und dürfen nicht in das Repository übernommen werden.

Tool

show akzeptiert 1–50 Orte mit dezimalen Breiten-/Längengradkoordinaten. Einfache Aufrufer können weiterhin connectPlaces verwenden; Reisepläne können zusätzlich Folgendes enthalten:

• Tages-/Datumsbezeichnungen mit Tagesfilterung

• Kategorien und Status (bestätigt/geplant/vorläufig)

• Transportabschnitte für Fußwege, Auto, Bus, Bahn, Fähre und Flüge

• Schematische gerade Verbindungen oder tatsächliche Routengeometrie

• Verifizierte Ortslinks, mit einem Google-Maps-Koordinatenlink als Fallback

Das Widget verwendet nummerierte, kategoriefarbene Marker, ein Reiseplan-Panel, eine Zurücksetzen-Aktion und optionale Vollbilddarstellung in ChatGPT. Schematische Abschnitte sind gestrichelt und explizit beschriftet, damit sie nicht mit Abbiegehinweisen verwechselt werden.

Kartendaten © OpenStreetMap-Mitwirkende.