English Français العربية

io.github.bhuvnsh/mcp-mapmyindia

Registre officiel Recherche et web

MCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @bhuvnsh/mcp-mapmyindia
Claude Code 
claude mcp add mcp-mapmyindia -e 'MAPPLS_API_KEY=<your mappls_api_key>' -e 'MAPPLS_CLIENT_ID=<MAPPLS_CLIENT_ID>' -e 'MAPPLS_CLIENT_SECRET=<your mappls_client_secret>' -- npx -y @bhuvnsh/mcp-mapmyindia@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-mapmyindia": {
            "command": "npx",
            "args": [
                "-y",
                "@bhuvnsh/mcp-mapmyindia@0.1.0"
            ],
            "env": {
                "MAPPLS_API_KEY": "<your mappls_api_key>",
                "MAPPLS_CLIENT_ID": "<MAPPLS_CLIENT_ID>",
                "MAPPLS_CLIENT_SECRET": "<your mappls_client_secret>"
            }
        }
    }
}

Variables d'environnement

  • MAPPLS_API_KEY secret Mappls API key — get one free at https://apis.mappls.com
  • MAPPLS_CLIENT_ID Mappls OAuth client ID (alternative to API key)
  • MAPPLS_CLIENT_SECRET secret Mappls OAuth client secret (used with CLIENT_ID)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mcp-mapmyindia
  2. Tools
  3. Setup
  4. Usage with Claude Desktop
  5. Development
  6. Contributing
  7. License

mcp-mapmyindia

MCP Server for Mappls / MapMyIndia APIs

An MCP (Model Context Protocol) server that exposes Mappls / MapMyIndia APIs as tools for AI assistants like Claude. Enables geocoding, reverse geocoding, place search, nearby discovery, routing, and distance calculations — all focused on India's mapping data.

Tools

ToolDescription
geocodeConvert an address or place name to coordinates
reverse_geocodeConvert coordinates (lat/lng) to a human-readable address
places_searchAutocomplete and search for places by query string
nearbyDiscover nearby places by keyword around a reference location
directionsGet turn-by-turn directions between two points (supports waypoints)
distance_matrixCompute travel distance and time between multiple origins and destinations
place_detailFetch detailed information for a place using its eLoc (Mappls place ID)

Setup

Get API credentials

Register at https://apis.mappls.com to get either:

  • An API key (simpler, for personal/testing use)
  • OAuth client credentials (recommended for production)
Authentication

Set one of the following in your environment:

Option A — OAuth (Client Credentials): RECOMMENDED

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

export MAPPLS_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your 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"
      }
    }
  }
}

Or with API key:

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

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Development

# 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
Requirements
  • Node.js >= 18
  • A Mappls API key or OAuth client credentials

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change. Pull requests should include tests.

License

MIT

Questions fréquentes

Qu'est-ce que io.github.bhuvnsh/mcp-mapmyindia ?

MCP server for India maps - place search, nearby discovery, & directions powered by the Mappls API.

Comment installer io.github.bhuvnsh/mcp-mapmyindia ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add mcp-mapmyindia -e 'MAPPLS_API_KEY=<your mappls_api_key>' -e 'MAPPLS_CLIENT_ID=<MAPPLS_CLIENT_ID>' -e 'MAPPLS_CLIENT_SECRET=<your mappls_client_secret>' -- npx -y @bhuvnsh/mcp-mapmyindia@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.bhuvnsh/mcp-mapmyindia ?

Oui. Il attend MAPPLS_API_KEY, MAPPLS_CLIENT_SECRET, à renseigner dans sa configuration.

io.github.bhuvnsh/mcp-mapmyindia est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.bhuvnsh/mcp-mapmyindia ?

Il est publié par bhuvnsh. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.