Mappls Mcp

io.github.AmanMakesStuff由 GitHub 帳號 AmanMakesStuff 發布v2.0.0更新於 Oct 24, 2026

MCP server for Mappls (MapMyIndia) — India-first maps API for AI agents

已驗證STDIO僅桌面位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

一個 MCP 伺服器，讓助理取得以印度為主的 Mappls（MapMyIndia）地理編碼、路線規劃、周邊搜尋與地圖工具。

可以做什麼
封裝 Mappls（MapMyIndia）地圖 API，提供以印度優先的位置資料。搜尋與地理編碼工具包括 geocode、reverse_geocode、autosuggest、text_search、nearby_search、place_details、address_analytics 與 validate_pincode。路線工具涵蓋 get_directions、含即時路況的路線與距離矩陣、沿途興趣點以及 snap_to_road。公用工具提供海拔、直線距離與靜態地圖圖片網址。
適用情境
當助理需要準確的印度地址、郵遞區號、地點搜尋，或印度境內的開車與步行路線時適用。適合以印度為中心的位置問題，這類情境下通用全球地圖伺服器精確度較低。
執行需求
透過 stdio 在本機執行，通常使用 npx mappls-mcp 或全域 npm 安裝，因此需要 Node.js。需要在 MAPPLS_API_KEY 環境變數中提供 Mappls 靜態 API 金鑰，可從免費的 Mappls 開發者帳號取得。需要連線至 Mappls API 的網路存取。
安裝前請注意
MAPPLS_API_KEY 祕密以明文寫入用戶端設定，請妥善保管設定檔。README 建議將 API 金鑰的 IP 白名單欄位留空以取得不受限的存取，這會取消金鑰使用位置的限制。請求會將地址與座標傳送給第三方服務 Mappls，並受其免費額度限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mappls Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mappls-mcp

An MCP (Model Context Protocol) server for Mappls — India's own maps platform (MapMyIndia). Gives AI agents accurate geocoding, routing, nearby search, and more for Indian addresses and locations.

Built because Google Maps MCP exists, but nothing existed for India-first location data.

Tools (18)

Search & Geocoding

ToolDescription
geocodeAddress or place name → lat/lng
reverse_geocodelat/lng → human-readable Indian address
autosuggestAutocomplete suggestions as user types
text_searchSearch by keyword or brand (e.g. "Starbucks Delhi")
nearby_searchFind hospitals, ATMs, petrol pumps, restaurants near a point
place_detailsFull details for a place using its eLoc code
address_analyticsStandardize a raw address into structured components
validate_pincodeValidate a 6-digit pincode, get district + state

Routing & Navigation

ToolDescription
get_directionsTurn-by-turn directions (driving/biking/walking)
get_directions_with_trafficTraffic-aware ETA using real-time conditions
distance_matrixDistances + durations between multiple points
distance_matrix_with_trafficTraffic-aware distance matrix
poi_along_routeFind fuel stations, restaurants, ATMs along a route
snap_to_roadSnap raw GPS coordinates to nearest road

Utilities

ToolDescription
elevationAltitude above sea level for any lat/lng point
aerial_distanceStraight-line (crow-fly) distance between two points
still_map_imageGenerate a static map image URL for any location

Getting Started

1. Get a Mappls API key (free)

  1. Sign up at about.mappls.com/api — free account, no credit card
  2. After login, click Create New Project → choose Cloud as the platform
  3. Open the project → go to the Credentials tab → copy the Static Key
  4. Go to the Whitelisting tab → leave the IP field blank for unrestricted access

The free tier includes generous API limits suitable for development and small projects.

2. Install

bash
npm install -g mappls-mcp

Or run directly without installing:

bash
npx mappls-mcp

Or clone and build locally:

bash
git clone https://github.com/AmanMakesStuff/mappls-mcpcd mappls-mcpnpm install && npm run build

3. Configure

Set your API key as an environment variable:

bash
export MAPPLS_API_KEY=your_static_key_here

Integration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "mappls": {      "command": "npx",      "args": ["mappls-mcp"],      "env": {        "MAPPLS_API_KEY": "your_static_key_here"      }    }  }}

Cursor / Windsurf

Add to your MCP settings:

json
{  "mappls": {    "command": "npx",    "args": ["mappls-mcp"],    "env": {      "MAPPLS_API_KEY": "your_static_key_here"    }  }}

Local build (alternative)

If you cloned the repo:

json
{  "mcpServers": {    "mappls": {      "command": "node",      "args": ["/absolute/path/to/mappls-mcp/build/index.js"],      "env": {        "MAPPLS_API_KEY": "your_static_key_here"      }    }  }}

Example Prompts

Once connected, ask your AI agent:

  • "Find the nearest hospital to Connaught Place, New Delhi"
  • "What's the address at 28.6139, 77.2090?"
  • "Get driving directions from Bandra to Andheri"
  • "Is pincode 400001 valid? What area is it?"
  • "How far is Delhi from Mumbai in a straight line?"
  • "What is the elevation of Shimla?"
  • "Find ATMs along the route from India Gate to Qutub Minar"
  • "Standardize this address: 237 Okhla Industrial Phase 3 ND 110020"
  • "Search for Domino's near Koramangala Bangalore"

Notes

  • All tools accept lat/lng in decimal degrees (e.g. 28.6139, 77.2090)
  • Routing tools use lat,lng format for input (the server handles coordinate conversion internally)
  • nearby_search uses plain keywords like "hospital", "atm", "restaurant" — Mappls maps these to category codes automatically
  • poi_along_route requires the encoded polyline from the geometry field of a get_directions response
  • still_map_image returns a URL — the image is a PNG map tile

License

MIT — built by AmanMakesStuff

來源：README.md，提交 37b4980

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v2.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。