Mappls Mcp

mappls-mcp

一个面向 Mappls 的 MCP（模型上下文协议）服务——印度本土的地图平台（MapMyIndia）。为 AI Agent 提供准确的地理编码、路线规划、附近搜索等功能，适用于印度地址和地点。

之所以开发它，是因为虽然已经有 Google Maps MCP，但此前没有面向印度本土位置数据的同类工具。

工具（18）

搜索与地理编码

工具	描述
geocode	地址或地点名称 → 纬度/经度
reverse_geocode	纬度/经度 → 易读的印度地址
autosuggest	根据用户输入提供自动补全建议
text_search	按关键词或品牌搜索（例如“Starbucks Delhi”）
nearby_search	查找某个点附近的医院、ATM、加油站、餐厅
place_details	使用地点的 eLoc 代码获取完整详情
address_analytics	将原始地址规范化为结构化组成部分
validate_pincode	验证 6 位邮政编码，并获取地区和邦

路线规划与导航

工具	描述
get_directions	逐转向导航（驾车/骑行/步行）
get_directions_with_traffic	根据实时路况计算交通感知型预计到达时间
distance_matrix	多个地点之间的距离和时长
distance_matrix_with_traffic	交通感知型距离矩阵
poi_along_route	查找路线沿途的加油站、餐厅、ATM
snap_to_road	将原始 GPS 坐标贴合到最近的道路

实用工具

工具	描述
elevation	获取任意纬度/经度点的海拔
aerial_distance	计算两点之间的直线距离（鸟飞距离）
still_map_image	为任意地点生成静态地图图片 URL

开始使用

1. 获取 Mappls API 密钥（免费）

1. 在 about.mappls.com/api 注册——免费账户，无需信用卡
2. 登录后，点击 Create New Project → 选择 Cloud 作为平台
3. 打开项目 → 转到 Credentials 选项卡 → 复制 Static Key
4. 转到 Whitelisting 选项卡 → 将 IP 字段留空，以允许不受限制的访问

免费套餐提供充足的 API 调用额度，适用于开发和小型项目。

2. 安装

npm install -g mappls-mcp

或直接运行，无需安装：

npx mappls-mcp

或克隆仓库并在本地构建：

git clone https://github.com/AmanMakesStuff/mappls-mcp
cd mappls-mcp
npm install && npm run build

3. 配置

将 API 密钥设置为环境变量：

export MAPPLS_API_KEY=your_static_key_here

---

集成

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

Cursor / Windsurf

添加到 MCP 设置中：

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

本地构建（替代方式）

如果你克隆了仓库：

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

---

示例提示词

连接后，可以向 AI Agent 提问：

• “查找新德里康诺特广场最近的医院”
• “28.6139, 77.2090 处的地址是什么？”
• “获取从班德拉到安泰里的驾车路线”
• “邮政编码 400001 有效吗？它属于哪个地区？”
• “德里到孟买的直线距离有多远？”
• “西姆拉的海拔是多少？”
• “查找印度门到库图布塔的路线沿途的 ATM”
• “规范化这个地址：237 Okhla Industrial Phase 3 ND 110020”
• “搜索班加罗尔科拉曼加拉附近的 Domino's”

---

说明

• 所有工具都接受十进制度数表示的纬度/经度（例如 28.6139, 77.2090）
• 路线规划工具的输入采用纬度,经度格式（服务会在内部处理坐标转换）
• nearby_search 使用 "hospital"、"atm"、"restaurant" 等普通关键词——Mappls 会自动将其映射到类别代码
• poi_along_route 需要 get_directions 响应中 geometry 字段提供的编码折线
• still_map_image 返回一个 URL——图片为 PNG 地图图块

许可证

MIT — 由 AmanMakesStuff 构建