Skip to main content
Glama
bhuvnsh

io.github.bhuvnsh/mcp-mapmyindia

by bhuvnsh

mcp-mapmyindia

MCP-сервер для API Mappls / MapMyIndia

CI npm version License: MIT

Сервер MCP (Model Context Protocol), предоставляющий API Mappls / MapMyIndia в виде инструментов для ИИ‑ассистентов, таких как Claude. Позволяет выполнять геокодирование, обратное геокодирование, поиск мест, поиск поблизости, построение маршрутов и расчёт расстояний — всё на основе картографических данных Индии.


Инструменты

Tool

Description

geocode

Преобразует адрес или название места в координаты

reverse_geocode

Преобразует координаты (широта/долгота) в понятный человеку адрес

places_search

Автодополнение и поиск мест по строке запроса

nearby

Поиск близлежащих мест по ключевому слову вокруг заданной точки

directions

Пошаговые инструкции для маршрута между двумя точками (поддерживает промежуточные точки)

distance_matrix

Вычисляет расстояние и время в пути между несколькими пунктами отправления и назначения

place_detail

Получает подробную информацию о месте по его eLoc (идентификатор места в Mappls)


Related MCP server: NextBillion.ai MCP Server

Настройка

Получение учётных данных API

Зарегистрируйтесь на https://apis.mappls.com, чтобы получить один из следующих вариантов:

  • API‑ключ (проще, для личного или тестового использования)

  • Учётные данные OAuth‑клиента (рекомендуется для продакшена)

Аутентификация

Задайте один из следующих способов в своём окружении:

Вариант A — OAuth (Client Credentials):

РЕКОМЕНДУЕТСЯ

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

Вариант B — API‑ключ:

export MAPPLS_API_KEY=your_api_key_here

Использование с Claude Desktop

Добавьте Юляш в файл 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"
      }
    }
  }
}

Или с API‑ключом:

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

Расположение файла конфигурации:

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

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


Разработка

# 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

Треб

  • Node.js >= 18

  • API‑ключ Mappls или учётные данные OAuth‑клиента


Вклад в проект

Вклад приветствуется. Пожалуйста, создайте issue, чтобы обсудить изменения, которые вы хотите внести. Пулы запросов должны быть включены тесты.


Лицензия

MIT

Related MCP Connectors

Related MCP Servers