google-maps-mcp-server

Google Maps MCP 服务

一个独立的模型上下文协议服务，通过 Techforce Global 的 Google Maps Scraper Apify Actor，将 Google Maps 商家搜索作为单个 MCP 工具提供。

工具

search_google_maps

按关键词和地点搜索 Google Maps 上的商家/地点。

参数	类型	必填	描述
searchQueries	string[]	是	一个或多个搜索词，例如 "restaurants in Delhi"
maxResults	integer	否	每个查询的最多地点数（默认 20，最多 500）
language	string	否	结果的语言代码，例如 "en"

返回结构化 JSON：商家名称、地址、电话、评分、营业时间和 GPS 坐标。

身份验证

每个请求都必须包含你自己的 Apify API 令牌：

Authorization: Bearer <YOUR_APIFY_TOKEN>

费用将计入令牌所有者的 Apify 账户，而非 Techforce Global。 请在 Apify Console → Settings → Integrations 获取令牌。

安装

托管版（推荐）

直接连接到托管端点，无需安装：

https://<your-vercel-project>.vercel.app/mcp

客户端配置示例（适用于 Claude Desktop / 任何支持 Streamable HTTP 的 MCP 客户端）：

{
  "mcpServers": {
    "google-maps": {
      "url": "https://<your-vercel-project>.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

本地运行

npm install
npm start

服务在 http://localhost:4000/mcp 上监听。

在 Vercel 上部署（免费）

本项目包含一个无服务器入口点（api/mcp.js）和一个 vercel.json 重写规则，因此公共端点可通过简洁的 /mcp 路径访问。

1. 前往 vercel.com，登录并点击 Add New → Project。
2. 导入此 GitHub 仓库（Sagar27888/google-maps-mcp-server）。
3. 框架预设：Other。无需构建命令 — Vercel 会自动检测 api/ 文件夹。
4. 点击 Deploy。
5. 公共端点将可通过 https://<your-vercel-project>.vercel.app/mcp 访问。

在 Apify 上部署（替代方案）

本项目也配置为支持 Standby 模式的 Apify Actor，可将其转换为长期运行的 HTTP 服务，而非一次性批处理任务。

1. 将本项目推送到 Apify 账户中的 Actor（Apify Console → Actors → Create new → 连接此 源代码，或使用 Apify CLI：apify push）。
2. 在 Actor 的 Settings → Standby 中，启用 Standby 模式。
3. 公共端点将可通过 https://<actor-name>.<your-apify-username>.apify.actor/mcp 访问。

许可证

MIT