google-maps-mcp-server

Google Maps MCP サーバー

Techforce Global の Google Maps Scraper Apify Actor を利用し、Google Maps のビジネス検索を単一の MCP ツールとして提供する、スタンドアロンの Model Context Protocol サーバーです。

ツール

search_google_maps

キーワードと場所を指定して、Google Maps でビジネスや場所を検索します。

パラメーター	型	必須	説明
searchQueries	string[]	はい	1 つ以上の検索語句。例："restaurants in Delhi"
maxResults	integer	いいえ	クエリごとの場所の最大数（デフォルトは 20、最大 500）
language	string	いいえ	結果の言語コード。例："en"

ビジネス名、住所、電話番号、評価、営業時間、GPS 座標を含む構造化 JSON を返します。

認証

すべてのリクエストに、ご自身の Apify API トークンを含める必要があります。

Authorization: Bearer <YOUR_APIFY_TOKEN>

利用料金は Techforce Global ではなく、トークン所有者の Apify アカウントに請求されます。 トークンは 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 mode 用に設定された Apify Actor としても利用できます。これにより、単発のバッチジョブではなく、長時間稼働する HTTP サービスとして動作します。

1. このプロジェクトを Apify アカウントの Actor にプッシュします（Apify Console → Actors → Create new → このソースを接続するか、Apify CLI で apify push を実行します）。
2. Actor の Settings → Standby で Standby mode を有効にします。
3. パブリックエンドポイントは https://<actor-name>.<your-apify-username>.apify.actor/mcp で利用できるようになります。

ライセンス

MIT