mapicgc-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mapicgc-mcp show me a code example for adding a 3D terrain to a map"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mapicgc-mcp
Servidor MCP (Model Context Protocol) que ensenya assistents d'IA (opencode, Claude, Cursor, GitHub Copilot...) a utilitzar correctament la llibreria mapicgc-gl-js de l'ICGC (documentació: https://openicgc.github.io/mapicgc-doc/).
Aquest MCP no executa ni empaqueta mapicgc-gl-js: només serveix text i dades (documentació, exemples de codi i la configuració d'estils/capes de l'ICGC) perquè un model d'IA sàpiga quina API fer servir i com.
English version below ⬇️ / Versió en anglès més avall
Què és?
mapicgc-gl-js és un embolcall de MapLibre GL JS amb funcions específiques per treballar amb les dades i serveis de l'ICGC (estils, capes vectorials i ràster, terrenys 3D, geocodificador, cerca territorial...). Aquest MCP exposa aquesta informació com a eines, recursos i prompts de l'estàndard Model Context Protocol, perquè qualsevol client MCP pugui consultar-la en temps real sense que calgui enganxar documentació manualment al context.
Related MCP server: mapbox-docs
Instal·lació
No cal instal·lar-lo manualment: qualsevol client MCP el pot executar amb
npx:
npx -y mapicgc-mcpSi vols treballar-hi en local (clonant aquest repositori):
npm install
npm run sync # descarrega la documentació real de mapicgc-gl-js a content/
npm run build # compila TypeScript a dist/
npm start # mode stdio
# o
npm run start:http # mode Streamable HTTP (PORT configurable, per defecte 3000)Configuració per client MCP
opencode
Afegeix al teu opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"mapicgc": {
"type": "local",
"command": ["npx", "-y", "mapicgc-mcp"],
"enabled": true
}
}
}Per a una versió desplegada per URL (Streamable HTTP):
{
"mcp": {
"mapicgc": {
"type": "remote",
"url": "https://el-teu-domini.exemple/mcp"
}
}
}Claude Desktop
A claude_desktop_config.json:
{
"mcpServers": {
"mapicgc": {
"command": "npx",
"args": ["-y", "mapicgc-mcp"]
}
}
}VS Code (GitHub Copilot)
A .vscode/mcp.json del teu projecte (o a la configuració d'usuari de VS Code):
{
"servers": {
"mapicgc": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mapicgc-mcp"]
}
}
}Eines (tools)
Eina | Descripció |
| Instal·lació (NPM i CDN) i exemple mínim de mapa. |
| Cerca per paraules clau a tota la documentació empaquetada. |
| Documentació d'un mètode o classe concret (p. ex. |
| Exemple de codi complet per a un tema (terreny 3D, marcadors, geocodificador...). |
| Estils, terrenys i grups de capes disponibles (en viu, amb còpia local de seguretat). |
| Historial de canvis complet, o d'una versió concreta. |
També registra els recursos mapicgc://readme i mapicgc://changelog, i el
prompt crear_mapa(estil, ubicacio).
Nota honesta: el README de mapicgc-gl-js esmenta "mapes estàtics" i un "motor de cerca de CRS" com a capacitats de la llibreria, però aquests mètodes no existeixen al codi font actual. Les capacitats reals i documentades aquí són: geocodificació (
addGeocoderICGC), geolocalització (addGeolocateControl), exportació de la vista a imatge/PDF (addExportControl) i cerca territorial per clic (addApiTerritorialICGC/searchApiTerritorialICGC).
Actualitzar el contingut
La documentació de content/ (README, referència de l'API i el CHANGELOG de
mapicgc-gl-js, més la còpia de seguretat de la configuració de l'ICGC) es
descarrega amb:
npm run syncEls exemples de content/examples/ estan escrits a mà (basats en exemples
reals del repositori de mapicgc-gl-js) i no es regeneren amb sync.
Publicar
npm run sync && npm run build
npm pack --dry-run # revisa què s'empaquetaria
npm publishmapicgc-mcp (English)
An MCP (Model Context Protocol) server that teaches AI assistants (opencode, Claude, Cursor, GitHub Copilot...) how to correctly use the mapicgc-gl-js library from ICGC (docs: https://openicgc.github.io/mapicgc-doc/).
This MCP does not run or bundle mapicgc-gl-js: it only serves text and data (documentation, code examples, and the ICGC style/layer configuration) so an AI model knows which API to use and how.
Installation
No manual install needed — any MCP client can run it with npx:
npx -y mapicgc-mcpFor local development (cloning this repo):
npm install
npm run sync # downloads the real mapicgc-gl-js docs into content/
npm run build # compiles TypeScript to dist/
npm start # stdio mode
# or
npm run start:http # Streamable HTTP mode (PORT env var, default 3000)Client configuration
See the Catalan section above for ready-to-use JSON snippets for opencode, Claude Desktop and VS Code — the configuration is identical regardless of language.
Tools
Tool | Description |
| Installation (NPM and CDN) and a minimal working map example. |
| Keyword search across all bundled documentation. |
| Detailed docs for a specific method/class (e.g. |
| A complete code example for a topic (3D terrain, markers, geocoder...). |
| Available styles, terrains and layer groups (live, with a local fallback). |
| Full changelog, or just one version's entries. |
It also registers the mapicgc://readme and mapicgc://changelog resources,
and the crear_mapa(estil, ubicacio) prompt.
Honesty note: the mapicgc-gl-js README mentions "static maps" and a "CRS search engine" as library capabilities, but no such methods exist in the current source code. The real, documented capabilities covered here are: geocoding (
addGeocoderICGC), geolocation (addGeolocateControl), exporting the current view to an image/PDF (addExportControl), and click-based territorial lookup (addApiTerritorialICGC/searchApiTerritorialICGC).
Updating content
Everything under content/ that comes straight from mapicgc-gl-js (README,
API reference, CHANGELOG, and the ICGC config fallback snapshot) is
downloaded with:
npm run syncFiles under content/examples/ are hand-written (based on real examples
from the mapicgc-gl-js repository) and are not regenerated by sync.
Publishing
npm run sync && npm run build
npm pack --dry-run # review what would be published
npm publishLicense
BSD-3-Clause, same as mapicgc-gl-js. See LICENSE.
Available Tools
6 toolsget_apiDocumentació d'un mètode o classe de mapicgc-gl-jsA
Retorna la documentació detallada (paràmetres, tipus i descripció) d'un mètode o classe concret de mapicgc-gl-js, p. ex. 'Map.addMarker', 'addGeocoderICGC' o 'Config.getConfigICGC'. Fes servir aquesta eina quan ja saps (o intueixes) el nom exacte de la funció.
Inputs: name (required).
get_changelogHistorial de canvis de mapicgc-gl-jsA
Retorna el CHANGELOG de mapicgc-gl-js, o només les entrades d'una versió concreta si se'n indica una (p. ex. '1.0.0').
Inputs: version.
get_exampleExemple de codi de mapicgc-gl-jsA
Retorna un exemple de codi complet i funcional per a un tema concret de mapicgc-gl-js (mapa bàsic, canviar d'estil, marcadors, terreny 3D, geocodificador, capes ICGC, comparador de mapes, exportar, etc.). Els exemples estan basats en l'API real de la llibreria.
Inputs: topic (required).
get_startedPrimers passos amb mapicgc-gl-jsA
Retorna les instruccions d'instal·lació (NPM i CDN) i un exemple mínim de mapa funcional amb mapicgc-gl-js. Útil com a primer pas quan algú vol començar un projecte nou amb la llibreria.
Inputs: no named parameters.
list_stylesEstils, capes i terrenys disponibles a l'ICGCA
Consulta en viu la configuració de l'ICGC (amb una còpia local de seguretat si la xarxa falla) i retorna els estils de mapa base, els terrenys 3D i els grups de capes (Orto, Vector, VectorAdmin, FGBAdmin, WMS) disponibles per usar amb mapicgc-gl-js.
Inputs: no named parameters.
search_docsCerca a la documentació de mapicgc-gl-jsA
Cerca per paraules clau a tota la documentació empaquetada de mapicgc-gl-js (README, referència de l'API i exemples) i retorna els fragments més rellevants amb el fitxer d'origen. Fes servir aquesta eina per trobar informació quan no saps el nom exacte d'un mètode o tema.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct documentation need (changelog, onboarding, keyword search, exact API lookup, topic examples, live style config). The only mild overlaps are get_started vs get_example (both return sample code) and search_docs vs get_api (both retrieve docs), but the descriptions clearly frame when to use each (exact name vs keyword, first-step vs full example).
All six tools follow a consistent snake_case verb_noun pattern (get_changelog, get_started, get_api, get_example, search_docs, list_styles). Verbs are used meaningfully: get_ for retrieval, search_ for querying, list_ for enumerating.
Six tools is a well-scoped set for a library documentation/assistant server. Each tool covers a distinct entry point (onboarding, search, API ref, examples, styles, changelog) with no filler.
The surface covers the main lifecycle of using a mapping library: getting started, finding docs, exact API reference, runnable examples, live style/terrain config, and version history. Minor gaps exist (e.g., no way to list available example topics or API symbols without guessing), but agents can work around this via search_docs.
Related MCP Connectors
Provides AI assistants with direct access to Mapbox developer APIs and documentation.
AI access to Mapbox docs, API references, style specs, and guides. No token required.
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to interact with Mapbox developer APIs for style management, token management, and local processing tasks like GeoJSON preview and coordinate conversion.231,634 npm62MIT

mapbox-docsofficial
AlicenseAqualityBmaintenanceProvides AI assistants with instant access to Mapbox documentation and reference materials through tools and resources, with no Mapbox access token required.3358 npm1MIT- FlicenseNot gradedqualityDmaintenanceEnables AI models to fetch GitHub repository information, read file contents, and search local documentation.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access Mapbox location services for geocoding, POI search, multi-modal routing, travel time analysis, isochrones, map matching, and interactive/static map rendering through natural language.MIT