MapGL MCP Server (prototype)
MapGL MCP Server
A small MCP prototype on top of 2GIS's MapGL JS API, giving an LLM map access for queries like comparing districts by cafe density
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- The server only reads MapGL map data
- The MapGL key is stored locally in the client config
Install
Manual install
{
"servers": {
"mapgl": {
"command": "node",
"args": ["<repo folder>/dist/index.js"],
"env": {
"MAPGL_API_KEY": "Your 2GIS API Key"
}
}
}
}The .vscode/mcp.json file from the README after building with npm run build.
This is third-party code. Review the repository files before installing.
What it does
The server provides LLM applications with access to 2GIS's MapGL JS API. The MapGL key is passed through an environment variable in the MCP client config. The author describes the project as a prototype and shows two usage examples in the README: comparing Moscow districts by cafe and park density within walking distance, and finding places serving onion soup in Yalta, with screenshots of the results in VS Code.
Who it is for. For developers who want to quickly try an LLM plus 2GIS maps combo in VS Code without a production-ready server.
Good fit when
- You want to quickly try the idea of place search and district comparison via 2GIS in an agent
- You work in VS Code with MCP and want a minimal connection example
- A prototype with no stability guarantees is acceptable
Not a fit when
- You need a mature tool with a documented method list: the README does not detail the tool list
- You need geocoding or routing as separate operations with a clear API
Example request
Compare the Akademichesky and Obruchevsky districts in Moscow by cafe and park density within walking distanceLimitations
The README does not explicitly list the server's tool set and limits itself to usage examples and screenshots. The author calls it a prototype outright, so interface stability is not guaranteed. It needs your own 2GIS MapGL API key.
How to disable. Remove the mapgl entry from .vscode/mcp.json or your MCP client's config.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| MAPGL_API_KEY required, secret | A 2GIS MapGL API key. |
Security check
- The server only reads MapGL map data
- The MapGL key is stored locally in the client config
README in short
The short English README describes the server as MapGL JS API access for LLM applications, gives npm install and npm run build install steps, a .vscode/mcp.json example with a MAPGL_API_KEY variable, and two screenshots of example queries about Moscow districts and Yalta venues.
FAQ
Is this an official 2GIS server?
No, it is an independent prototype on top of 2GIS's public MapGL JS API; the README does not link it to the vendor.
What tools are available to the agent?
The README gives no detailed list, only example place and district queries with result screenshots.
Related
166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases
Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml
Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment
A visualization language for agents and an MCP server: neat charts from a simple semantic spec