Skip to main content
Glama
bhuvnsh

io.github.bhuvnsh/mcp-mapmyindia

by bhuvnsh

mcp-mapmyindia

Servidor MCP para las APIs de Mappls / MapMyIndia

CI npm version License: MIT

Un servidor MCP (Model Context Protocol) que expone las APIs de Mappls / MapMyIndia como herramientas para asistentes de IA como Claude. Permite geocodificación, geocodificación inversa, búsqueda de lugares, descubrimiento de lugares cercanos, rutas y cálculos de distancia, todo centrado en los datos cartográficos de la India.


Herramientas

Herramienta

Descripción

geocode

Convierte una dirección o nombre de lugar en coordenadas

reverse_geocode

Convierte coordenadas (lat/lng) en una dirección legible

places_search

Autocompleta y busca lugares por cadena de consulta

nearby

Descubre lugares cercanos por palabra clave alrededor de una ubicación de referencia

directions

Obtén indicaciones paso a paso entre dos puntos (admite puntos de ruta)

distance_matrix

Calcula la distancia y el tiempo de viaje entre múltiples orígenes y destinos

place_detail

Obtén información detallada de un lugar usando su eLoc (ID de lugar de Mappls)


Related MCP server: NextBillion.ai MCP Server

Configuración

Obtener credenciales de API

Regístrate en https://apis.mappls.com para obtener cualquiera de los siguientes:

  • Una clave de API (más simple, para uso personal/pruebas)

  • Credenciales de cliente OAuth (recomendado para producción)

Autenticación

Configura una de las siguientes opciones en tu entorno:

Opción A — OAuth (Credenciales de cliente): RECOMENDADO

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Opción B — Clave de API:

export MAPPLS_API_KEY=your_api_key_here

Uso con Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_CLIENT_ID": "your_client_id",
        "MAPPLS_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

O con clave de API:

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvnsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Ubicación del archivo de configuración:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json


Desarrollo

# Clone and install
git clone https://github.com/bhuvnsh/mcp-mappls.git
cd mcp-mappls
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode (dev)
npm run dev

Requisitos

  • Node.js >= 18

  • Una clave de API de Mappls o credenciales de cliente OAuth


Contribuciones

Las contribuciones son bienvenidas. Abre primero un issue para discutir lo que te gustaría cambiar. Las solicitudes de extracción deben incluir pruebas.


Licencia

MIT

Related MCP Connectors

Related MCP Servers