{
  "markdown": "# mapnetwork-mcp\n\nMCP server for [MapNetwork](https://mapnetwork.app) — generate styled map images (PNG / SVG) for any location on Earth, directly from Claude or any MCP-compatible AI assistant.\n\n## Features\n\n- Generate maps from a place name, a list of markers, or a walking/driving route\n- 11 color themes (white, darkBlue, darkGreen, popArt, lightBlue, lightGreen, beige, magenta, gray, black, brown)\n- PNG or SVG output, saved to your Downloads folder\n- Slow-to-generate maps are handled automatically — `generate_*` tools poll internally, and `download_map` can pick up a job later if needed\n- Re-download a previously generated map in a different theme or format without regenerating\n- Open any generated map in the MapNetwork web editor for manual customization\n\n## Example Usage\n\n**Prompt:** \"Generate a map around the 21st Century Museum of Contemporary Art, Kanazawa.\"\n\nHere is the map it generated:\n<img src=\"https://raw.githubusercontent.com/toruproject/mapnetwork-mcp/main/images/Kanazawa21Museum-white.png\" width=\"400\" alt=\"Map Drawing Example\">\n\n**Prompt:** \"Redownload that map in a few different color themes.\"\n\nThe same map, redownloaded in different color themes:\n\n|                                                        Dark Green Style                                                         |                       Light Green Style                        |                          Pop Art Style                           |                        Black Style                        |\n|:-------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------:|:----------------------------------------------------------------:|:---------------------------------------------------------:|\n| <img src=\"https://raw.githubusercontent.com/toruproject/mapnetwork-mcp/main/images/Kanazawa21Museum-darkGreen.png\" width=\"160\"> | <img src=\"https://raw.githubusercontent.com/toruproject/mapnetwork-mcp/main/images/Kanazawa21Museum-lightGreen.png\" width=\"160\"> | <img src=\"https://raw.githubusercontent.com/toruproject/mapnetwork-mcp/main/images/Kanazawa21Museum-popArt.png\" width=\"160\"> | <img src=\"https://raw.githubusercontent.com/toruproject/mapnetwork-mcp/main/images/Kanazawa21Museum-black.png\" width=\"160\"> |\n\n## Installation\n\n### Claude Desktop\n\n#### Using the .mcpb extension file (recommended)\n\nThe easiest way to install is via the `.mcpb` extension file available on the [Releases](https://github.com/toruproject/mapnetwork-mcp/releases) page.\n\n1. Download the latest `.mcpb` file from the Releases page.\n2. Open Claude Desktop and go to **Settings** → **Extensions**.\n3. Drag the downloaded `.mcpb` file onto the Extensions panel to install.\n\n#### Manual configuration\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mapnetwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mapnetwork-mcp\"],\n      \"alwaysAllow\": [\"generate_map\", \"generate_markers_map\", \"generate_route_map\", \"download_map\", \"redownload_map\"]\n    }\n  }\n}\n```\n\nIf you use `pip` instead of `uvx`:\n\n```bash\npip install mapnetwork-mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"mapnetwork\": {\n      \"command\": \"mapnetwork-mcp\"\n    }\n  }\n}\n```\n\n## Remote MCP Server\n\nYou can also use MapNetwork through MCP without installing anything, via the remote MCP server:\n\n```\nhttps://mapnetwork.app/mcp\n```\n\nIn Claude, go to **Settings** → **Connectors** → **Add custom connector** and register the URL above.\n\nThe 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 a download link and a link to edit the map at [mapnetwork.app](https://mapnetwork.app). Open the links in a browser to view or save the image, or to edit the map.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `generate_map` | Generate a styled map image centered on a single place and save it to Downloads |\n| `generate_markers_map` | Generate a map with multiple pinned locations |\n| `generate_route_map` | Compute a walking or driving route between two places and generate a map with it overlaid |\n| `download_map` | Check a pending `generate_*` job and download it once ready |\n| `redownload_map` | Re-download a previously generated map in a different color theme or format — instant, no regeneration |\n\n## Example prompts\n\n**Japanese**\n- \"東京タワー周辺の地図を作って\"\n- \"上野駅が最寄りの美術館・博物館を地図にして\"\n- \"赤坂駅から赤坂氷川神社までの徒歩ルートを地図にして\"\n- \"その地図を darkBlue テーマでSVG画像で出し直して\"\n- \"生成した地図の編集用リンクをください\"\n\n**English**\n- \"Generate a map around Tokyo Tower\"\n- \"Show a map of the museums near Ueno Station\"\n- \"Show a walking route from Akasaka Station to Akasaka Hikawa Shrine on a map\"\n- \"Redownload that map as an SVG in the darkBlue theme\"\n- \"Give me a link to edit the generated map\"\n\n## Links\n\n- Web UI: [https://mapnetwork.app](https://mapnetwork.app)\n- Web UI Manual: [https://mapnetwork.app/manual](https://mapnetwork.app/manual)\n- API docs: [https://mapnetwork.app/openapi.json](https://mapnetwork.app/openapi.json)\n\nmcp-name: io.github.toruproject/mapnetwork-mcp\n",
  "bytes": 5365,
  "sha": "196a2bbffcfe22873ac2eb3c6815bbcc28267a732196b4e3ce97087d448d0080",
  "repo_slug": "toruproject/mapnetwork-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_toruproject_mapnetwork_mcp_0b8c3ee5/readme"
}