English Français العربية

io.github.Sagar27888/google-maps-mcp-server

السجل الرسمي البحث والويب

Search Google Maps businesses via MCP - name, address, phone, rating, hours, GPS.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http google-maps-mcp-server 'https://google-maps-mcp-server.vercel.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "google-maps-mcp-server": {
            "type": "http",
            "url": "https://google-maps-mcp-server.vercel.app/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Google Maps MCP Server
  2. Tool
  3. Authentication
  4. Installation
  5. Deploying on Vercel (free)
  6. Deploying on Apify (alternative)
  7. License

Google Maps MCP Server

A standalone Model Context Protocol server that exposes Google Maps business search as a single MCP tool, backed by Techforce Global's Google Maps Scraper Apify Actor.

Tool

search_google_maps

Search Google Maps for businesses/places by keyword and location.

ParameterTypeRequiredDescription
searchQueriesstring[]yesOne or more search terms, e.g. "restaurants in Delhi"
maxResultsintegernoMax places per query (default 20, max 500)
languagestringnoLanguage code for results, e.g. "en"

Returns structured JSON: business name, address, phone, rating, opening hours, and GPS coordinates.

Authentication

Every request must include your own Apify API token:

Authorization: Bearer <YOUR_APIFY_TOKEN>

Usage is billed to the token owner's Apify account, not to Techforce Global. Get your token at Apify Console → Settings → Integrations.

Installation

Connect directly to the hosted endpoint — no install required:

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

Example client config (Claude Desktop / any MCP client supporting Streamable HTTP):

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

Server listens on http://localhost:4000/mcp.

Deploying on Vercel (free)

This project includes a serverless entry point (api/mcp.js) and a vercel.json rewrite so the public endpoint is available at a clean /mcp path.

  1. Go to vercel.com, sign in, click Add New → Project.
  2. Import this GitHub repo (Sagar27888/google-maps-mcp-server).
  3. Framework preset: Other. No build command needed — Vercel auto-detects the api/ folder.
  4. Click Deploy.
  5. The public endpoint becomes available at https://<your-vercel-project>.vercel.app/mcp.

Deploying on Apify (alternative)

This project is also an Apify Actor configured for Standby mode, which turns it into a long-running HTTP service instead of a one-shot batch job.

  1. Push this project to an Actor on your Apify account (Apify Console → Actors → Create new → connect this source, or use the Apify CLI: apify push).
  2. In the Actor's Settings → Standby, enable Standby mode.
  3. The public endpoint becomes available at https://<actor-name>.<your-apify-username>.apify.actor/mcp.

License

MIT

الأسئلة الشائعة

ما هو io.github.Sagar27888/google-maps-mcp-server؟

Search Google Maps businesses via MCP - name, address, phone, rating, hours, GPS.

كيف أثبّت io.github.Sagar27888/google-maps-mcp-server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http google-maps-mcp-server 'https://google-maps-mcp-server.vercel.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Sagar27888/google-maps-mcp-server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Sagar27888/google-maps-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Sagar27888/google-maps-mcp-server؟

ينشره Sagar27888. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.