Erstelle stilisierte PNG- oder SVG-Kartenbilder von Orten in Japan mit anpassbaren Farbschemata und Routen-Overlays.
Auch bekannt als toruproject/mapnetwork-mcp, mapnetwork-mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 Tage
- 695
- Neueste Version
- 6.2.1
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist MapNetwork MCP?
Erstelle stilisierte PNG- oder SVG-Kartenbilder von Orten in Japan mit anpassbaren Farbschemata und Routen-Overlays. Er stellt 5 Tools bereit, etwa generate_map, generate_markers_map, generate_route_map.
Zusammenfassung generiert aus dem README des Projekts
Über MapNetwork MCP server
MapNetwork ermöglicht es dir, stilisierte, illustrationsartige Kartenbilder von Orten innerhalb Japans zu erstellen. Durch die Nutzung von OpenStreetMap-Daten über eine dedizierte Overpass API generiert der Server PNG- oder SVG-Dateien mit verschiedenen ästhetischen Optionen. Du kannst aus elf verschiedenen Farbschemata wählen, darunter popArt, darkBlue und beige, um sie an deine visuellen Anforderungen anzupassen. Der Service ist für alle gedacht, die maßgeschneiderte Karten für japanische Standorte benötigen, gibt jedoch derzeit Fehler bei Anfragen außerhalb von Japan zurück.
Entwickler können dies als lokalen Server via Claude Desktop über eine .mcpb-Datei oder durch manuelle Konfiguration mit uvx oder pip bereitstellen. Dieses lokale Setup ermöglicht das automatische Speichern von Bildern direkt in einen Downloads-Ordner. Alternativ steht ein Remote MCP server über eine URL zur Verfügung, falls du keine Software lokal installieren möchtest. Während die lokale Version Dateien direkt speichert, bietet die Remote-Version Textlinks zum Herunterladen, Bearbeiten oder zum Betrachten der Karten in 3D in einem Webbrowser an.
Was du damit machen kannst
- 1Standortkarten erstellenGeneriere eine stilisierte Karte, die auf ein bestimmtes Wahrzeichen oder einen Ortsnamen zentriert ist.
- 2Reiserouten visualisierenErstelle eine Karte, die einen Fußweg oder eine Fahrtroute zwischen zwei spezifischen Punkten zeigt.
- 3Eigene Themes anwendenÄndere den visuellen Stil einer bestehenden Karte in ein anderes Farbschema oder ein anderes Dateiformat.
- 43D-Renderings aufrufenBetrachte eine dreidimensionale Darstellung einer generierten Karte in einem Desktop-Browser.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du MapNetwork MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenMapNetwork MCP in Claude Code installieren
$ claude mcp add mapnetwork-mcp -- uvx mapnetwork-mcpMapNetwork MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mapnetwork-mcp": {
"command": "uvx",
"args": [
"mapnetwork-mcp"
]
}
}
}MapNetwork MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mapnetwork-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mapnetwork-mcp"
]
}
}
}MapNetwork MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mapnetwork-mcp","type":"stdio","command":"uvx","args":["mapnetwork-mcp"]}'MapNetwork MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mapnetwork-mcp": {
"command": "uvx",
"args": [
"mapnetwork-mcp"
]
}
}
}MapNetwork MCP in Codex installieren
$ codex mcp add mapnetwork-mcp -- uvx mapnetwork-mcpMapNetwork MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mapnetwork-mcp] command = "uvx" args = ["mapnetwork-mcp"]
MapNetwork MCP in Gemini CLI installieren
$ gemini mcp add -s user mapnetwork-mcp uvx -- mapnetwork-mcpMapNetwork MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mapnetwork-mcp": {
"command": "uvx",
"args": [
"mapnetwork-mcp"
]
}
}
}MapNetwork MCP tools 5
Erkannt aus dem READMEgenerate_mapgenerate_markers_mapgenerate_route_mapdownload_mapredownload_map
| generate_map | — | |
| generate_markers_map | — | |
| generate_route_map | — | |
| download_map | — | |
| redownload_map | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbartoruproject/mapnetwork-mcp is public and reachablegithub.com/toruproject/mapnetwork-mcp ↗Bestanden
- Paket nennt dieses Repository als Quellemapnetwork-mcp names toruproject/mapnetwork-mcp as sourcepypi.org/project/mapnetwork-mcp/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for mapnetwork-mcppypi.org/project/mapnetwork-mcp/ ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/toruproject/mapnetwork-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from mapnetwork-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten37 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 1145 msBestanden
README
Auf GitHub ansehenEnglish | 日本語
mapnetwork-mcp
MCP server for MapNetwork — turn places in Japan into styled, illustration-like map images (PNG / SVG), directly from Claude or any MCP-compatible AI assistant.
Maps are built from detailed OpenStreetMap data served by MapNetwork's own Overpass API for Japan, so coverage is currently limited to Japan (country code JP) — requests for places outside Japan return an error.
Since MapNetwork is built for Japan, a Japanese version of this README is also available: README.ja.md.
Features
- Generate a map from a place name or a list of markers
- Overlay a walking / driving route between two places
- 11 color themes (white, darkBlue, darkGreen, popArt, lightBlue, lightGreen, beige, magenta, gray, black, brown)
- PNG or SVG output, saved to your Downloads folder
- Slow-to-generate maps are handled automatically —
generate_*tools poll internally, anddownload_mapcan pick up a job later if needed - Re-download a previously generated map in a different theme or format without regenerating
- Open any generated map in the MapNetwork web editor for manual customization
- View any generated map in 3D — each result includes a link that draws a 3D rendering of the map in your own desktop browser and shows it as an image (not available on mobile devices)
Example Usage
Prompt: "城崎温泉の外湯を地図にして。" (Make a map of the public bathhouses of Kinosaki Onsen.)
The map it generated, saved to your Downloads folder:
The result also includes three links. Open them in a browser to get more out of the same map — no need to regenerate.
Download link — change the color theme by editing the link's colorSet parameter (here &colorSet=black):
View 3D link — a 3D rendering of the map, drawn in your desktop browser and shown as an image:
Open in editor link — customize the map by hand in the MapNetwork web editor (here: buildings hidden, patchwork turned on, and the popArt color theme applied):
Installation
Claude Desktop
Using the .mcpb extension file (recommended)
The easiest way to install is via the .mcpb extension file available on the Releases page.
- Download the latest
.mcpbfile from the Releases page. - Open Claude Desktop and go to Settings → Extensions.
- Drag the downloaded
.mcpbfile onto the Extensions panel to install.
Manual configuration
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"mapnetwork": {
"command": "uvx",
"args": ["mapnetwork-mcp"],
"alwaysAllow": ["generate_map", "generate_markers_map", "generate_route_map", "download_map", "redownload_map"]
}
}
}
If you use pip instead of uvx:
pip install mapnetwork-mcp
{
"mcpServers": {
"mapnetwork": {
"command": "mapnetwork-mcp"
}
}
}
Remote MCP Server
You can also use MapNetwork through MCP without installing anything, via the remote MCP server:
https://mapnetwork.app/mcp
In Claude, go to Settings → Connectors → Add custom connector and register the URL above.
The key difference from this local server is how you receive the generated map image. Since mapnetwork-mcp runs on your PC, it can save the generated image directly to your Downloads folder. The remote server can't do this — most AI assistants are unable to properly display or save tool-result images within the chat — so instead of image data, it returns a text response with three links at mapnetwork.app: a download link for the PNG, a link to edit the map, and a link to view the map in 3D (the 3D rendering is drawn in your own desktop browser and shown as an image after a few seconds; it is not available on mobile devices). Open the links in a browser to view or save the image, to edit the map, or to see it in 3D. The local server returns the same three links after saving the PNG.
Tools
| Tool | Description |
|---|---|
generate_map |
Generate a styled map image centered on a single place and save it to Downloads |
generate_markers_map |
Generate a map with multiple pinned locations |
generate_route_map |
Compute a walking or driving route between two places and generate a map with it overlaid |
download_map |
Check a pending generate_* job and download it once ready |
redownload_map |
Re-download a previously generated map in a different color theme or format — instant, no regeneration |
Example prompts
Japanese
- "東京タワー周辺の地図を作って"
- "上野駅が最寄りの美術館・博物館を地図にして"
- "赤坂駅から赤坂氷川神社までの徒歩ルートを地図にして"
- "その地図を darkBlue テーマでSVG画像で出し直して"
- "生成した地図の編集用リンクをください"
English
- "Generate a map around Tokyo Tower"
- "Show a map of the museums near Ueno Station"
- "Show a walking route from Akasaka Station to Akasaka Hikawa Shrine on a map"
- "Redownload that map as an SVG in the darkBlue theme"
- "Give me a link to edit the generated map"
Links
- Web UI: https://mapnetwork.app
- Web UI Manual: https://mapnetwork.app/manual
- API docs: https://mapnetwork.app/openapi.json
mcp-name: io.github.toruproject/mapnetwork-mcp
MapNetwork MCP Fragen
Wie füge ich MapNetwork MCP zu Claude Code hinzu?
Führe claude mcp add mapnetwork-mcp -- uvx mapnetwork-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich MapNetwork MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet MapNetwork MCP?
Er stellt 5 Tools bereit, darunter generate_map, generate_markers_map, generate_route_map, download_map, redownload_map.
Welche geografischen Gebiete werden unterstützt?
Der Service ist derzeit auf Japan (Ländercode JP) beschränkt. Anfragen für Orte außerhalb von Japan führen zu einem Fehler.
Kann ich das Aussehen der Karten anpassen?
Ja, du kannst aus 11 verschiedenen Farbschemata wählen und die Karten im PNG- oder SVG-Format ausgeben.
Wie kann ich eine bereits generierte Karte bearbeiten?
Jede generierte Karte enthält einen Link, mit dem du sie im MapNetwork Web-Editor zur manuellen Anpassung öffnen kannst.
Gibt es eine 3D-Ansicht?
Ja, jedes Ergebnis enthält einen Link, um eine 3D-Rendering der Karte in deinem Desktop-Browser anzuzeigen, allerdings ist dies auf mobilen Geräten nicht verfügbar.