English Français العربية

io.github.bhuvnsh/mcp-mapmyindia

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • MAPPLS_API_KEY سري 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 سري Mappls OAuth client secret (used with CLIENT_ID)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.bhuvnsh/mcp-mapmyindia؟

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

كيف أثبّت io.github.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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.bhuvnsh/mcp-mapmyindia إلى مفتاح API؟

نعم. يتطلب MAPPLS_API_KEY, MAPPLS_CLIENT_SECRET، وتضبطها في إعداداته.

هل io.github.bhuvnsh/mcp-mapmyindia مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.bhuvnsh/mcp-mapmyindia؟

ينشره bhuvnsh. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.