Skip to main content
Glama
bhuvnsh

io.github.bhuvnsh/mcp-mapmyindia

by bhuvnsh

mcp-mapmyindia

用于 Mappls / MapMyIndia API 的 MCP 服务器

CI npm version License: MIT

一个 MCP(模型上下文协议) 服务器,将 Mappls / MapMyIndia API 作为工具提供给 Claude 等 AI 助手使用。支持地理编码、反向地理编码、地点搜索、周边发现、路线规划和距离计算——全部聚焦于印度的地图数据。


工具

工具

描述

geocode

将地址或地名转换为坐标

reverse_geocode

将坐标(纬度/经度)转换为人类可读的地址

places_search

通过查询字符串自动补全和搜索地点

nearby

在参考位置周围按关键词发现附近地点

directions

获取两点之间的逐向导航路线(支持途经点)

distance_matrix

计算多个起点和终点之间的行驶距离和时间

place_detail

使用 eLoc(Mappls 地点 ID)获取地点的详细信息


Related MCP server: NextBillion.ai MCP Server

设置

获取 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

Related MCP Connectors

Related MCP Servers