Geoapify Map Generator

🚀 Geoapify MCP Server

Convert addresses to GPS coordinates for mapping and optionally generate images of these coordinates using the Geoapify server.

🚀 Quick Start

📦 Installation

You need to obtain an API key from Geoapify and set it as the environment variable GEO_APIKEY.

Your claude_desktop_config.json file will look like this after installation:

"MCP Map Demo": {
      "command": "uv",
      "args": [
	"--directory",
        "/PATH/TO/THIS/REPO",
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with",
        "folio",
        "--with",
        "selenium",
        "--with",
        "pillow",
        "fastmcp",
        "run",
        "/PATH/TO/THIS/REPO/server.py"
      ],
      "env": {
        "GEO_APIKEY": "YOURAPIKEY"
      }
    }

Note that we've included all dependencies in the args.

✨ Features

Tools

• get_gps_coordinates: Used to obtain GPS coordinates from the API to create GeoJSON, etc.
• create_map_from_geojson: Create a map image based on GeoJSON and display it. (Currently, the display function is only supported on MacOS.)

💻 Usage Examples

Basic Usage

Get GPS Coordinates

Can you generate a GeoJSON file containing the following locations and their GPS coordinates: 179 avenue du Général Leclerc, côté Rive Gauche
158 avenue du Général Leclerc, côté Rive Droite à l'angle de la rue Jules Herbron
112 avenue du Général Leclerc, côté Rive Droite
34 avenue du Général Leclerc, côté Rive Droite
En face du 57 rue Gaston Boissier, à côté de la borne
Route du Pavé de Meudon - à côté du chêne de la Vierge
6 avenue de Versailles (près du centre aquatique des Bertisettes)
3 places sur parking de la rue Costes et Bellonte
Rue Joseph Chaleil
18 rue des Sables – à côté de la crèche
25 sente de la Procession
33 rue Joseph Bertrand
Place Saint Paul
Place de la bataille de Stalingrad
Placette croisement avenue Pierre Grenier / avenue Robert Hardouin
107 avenue Gaston Boissier (en face de la caserne des pompiers)

Result: Attached JSON file

Returns a GeoJSON file.

Create a Map Image

Can you generate a map based on the attached GeoJSON file I provided?

Attached JSON file

Result:

📄 License

MIT