Mcp Mapmyindia

io.github.bhuvnsh由 GitHub 账号 bhuvnsh 发布v0.1.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面位置与生活网页搜索与抓取

概览

AI 生成的概览

本地 MCP 服务器，封装 Mappls / MapMyIndia 地图 API，让助手在印度范围内进行地理编码、地点搜索、周边发现和路线查询。

可以做什么
把地址或地名转换为坐标，并把坐标反查为可读地址（geocode、reverse_geocode）。按关键词搜索和自动补全地点，并通过 Mappls eLoc 地点 ID 获取地点详情。围绕参考位置按关键词发现周边地点。获取两点之间的逐步导航路线，支持途经点。计算多个起点与终点之间的行驶距离和时间。
适用场景
适合需要印度本地位置信息的场景：把印度地址解析为坐标、查找附近的地点或商户，或规划两点之间的路线与出行时间。
运行要求
通过 npx 在本地运行，需要 Node.js 18 或更高版本。需要 Mappls 账号，可通过 MAPPLS_API_KEY 提供 API 密钥，或通过 MAPPLS_CLIENT_ID 与 MAPPLS_CLIENT_SECRET 提供 OAuth 凭据。需要能访问 Mappls API 的网络连接。
安装前请注意
需要 Mappls API 凭据，属于机密：MAPPLS_API_KEY 或 MAPPLS_CLIENT_SECRET。这些凭据会写入助手的配置文件，需妥善保护该文件。查询内容和坐标会发送给 Mappls 的第三方 API。README 中的 OAuth 示例所用包名与已发布的包名不一致，安装前请核对包名。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Mapmyindia，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-mapmyindia

MCP Server for Mappls / MapMyIndia APIs

[CI] [npm version] [License: MIT]

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

bash
export MAPPLS_CLIENT_ID=your_client_idexport MAPPLS_CLIENT_SECRET=your_client_secret

Option B — API Key:

bash
export MAPPLS_API_KEY=your_api_key_here

Usage with Claude Desktop

Add to your claude_desktop_config.json:

OAuth
{  "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:

json
{  "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

bash
# Clone and installgit clone https://github.com/bhuvnsh/mcp-mappls.gitcd mcp-mapplsnpm install
# Buildnpm run build
# Run testsnpm 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

来源：README.md，提交 84ab874

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分