mcpField
M
mcp-mapmyindia

mcp-mapmyindia

本地服务
github.com/bhuvnsh地图与出行032 周前更新
代码仓库

关于 mcp-mapmyindia

mcp-mapmyindia 将 Mappls / MapMyIndia 地图 API 提供为工具，供 AI 助手处理印度地理数据。它支持地点查询、地理编码、路线规划以及距离和行程时间计算。

主要功能

  1. 01正向与反向地理编码
  2. 02地点搜索和附近地点发现
  3. 03支持途经点的路线规划
  4. 04距离与行程时间矩阵
  5. 05按 eLoc 查询地点详情

适用场景

  1. 01查找印度地址的坐标
  2. 02按关键词发现附近地点
  3. 03获取地点间路线
  4. 04比较多条路线的距离和时间

MCP 相关

向 MCP 客户端提供 Mappls / MapMyIndia 的地理编码、地点搜索、路线、距离矩阵和地点详情 API 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "bhuvnsh-mcp-mapmyindia": {
      "command": "npx",
      "args": [
        "-y",
        "@bhuvnsh/mcp-mapmyindia"
      ],
      "env": {
        "MAPPLS_API_KEY": "<MAPPLS_API_KEY>",
        "MAPPLS_CLIENT_ID": "<MAPPLS_CLIENT_ID>",
        "MAPPLS_CLIENT_SECRET": "<MAPPLS_CLIENT_SECRET>"
      }
    }
  }
}
启动命令npx -y @bhuvnsh/mcp-mapmyindia
需要配置的环境变量
MAPPLS_API_KEY密钥Mappls API key — get one free at https://apis.mappls.com
MAPPLS_CLIENT_IDMappls OAuth client ID (alternative to API key)
MAPPLS_CLIENT_SECRET密钥Mappls OAuth client secret (used with CLIENT_ID)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@bhuvnsh/mcp-mapmyindia0.1.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-mapmyindia

适用于 Mappls / MapMyIndia API 的 MCP 服务

CI npm version License: MIT

这是一个 MCP（Model Context Protocol） 服务，可将 Mappls / MapMyIndia API 作为工具提供给 Claude 等 AI 助手。支持地理编码、逆地理编码、地点搜索、附近地点发现、路线规划和距离计算，所有功能均聚焦于印度的地图数据。

工具

工具描述
geocode将地址或地点名称转换为坐标
reverse_geocode将坐标（纬度/经度）转换为易读的地址
places_search根据查询字符串自动补全并搜索地点
nearby根据关键词查找参考位置周边的地点
directions获取两点之间的逐向导航路线（支持途经点）
distance_matrix计算多个起点和终点之间的出行距离和时间
place_detail使用地点的 eLoc（Mappls 地点 ID）获取详细信息

设置

获取 API 凭据

在 https://apis.mappls.com 注册，以获取以下任一凭据：

  • API 密钥（更简单，适用于个人使用或测试）
  • OAuth 客户端凭据（推荐用于生产环境）
身份验证

在环境中设置以下其中一项：

选项 A — OAuth（客户端凭据）： 推荐

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
  • Mappls API 密钥或 OAuth 客户端凭据

贡献

欢迎贡献。请先创建 issue，讨论你希望进行的更改。拉取请求应包含测试。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。