Google Places MCP Server

Google Places MCP サーバー

この MCP サーバーは Google Places API と連携し、場所の検索、詳細情報の取得、近くの場所の検索を可能にします。

セットアップ

環境変数

次の環境変数が必要です。

• GOOGLE_MAPS_API_KEY：Places API へのアクセスが有効になっている Google Maps API キー
• TRANSPORT_TYPE：使用するトランスポート方式（stdio または sse）
• PORT：（任意）SSE トランスポート用のポート番号（デフォルト：3000）

ルートディレクトリに、次の変数を設定した .env ファイルを作成します。

GOOGLE_MAPS_API_KEY=your_api_key_here
PORT=3000

開発

1. 依存関係をインストールします。

npm install

2. 開発サーバーを起動します。

npm run dev

トランスポートオプション

サーバーは次の 2 つのトランスポート方式をサポートしています。

1. SSE（Server-Sent Events）：リアルタイム通信に Server-Sent Events を使用する HTTP 方式です。

SSE トランスポートを使用すると、サーバーは次の 2 つのエンドポイントを公開します。

• GET /sse：サーバーメッセージを受信するための SSE エンドポイント
• POST /messages：サーバーにメッセージを送信するためのエンドポイント

ツール

• places-text-search

  • Google Places API を使用して場所をテキスト検索します
  • 入力：
    • textQuery（string、必須）：場所を検索するためのテキストクエリ
    • includedType（string、任意）：指定したタイプに一致する場所に結果を限定します
    • includePureServiceAreaBusinesses（boolean、任意）：物理的な所在地を持たない事業者を含めます
    • languageCode（string、任意）：結果の言語コード（例："en"）
    • locationBias（object、任意）：この場所を基準に結果を絞り込みます
    • locationRestriction（object、任意）：結果をこの場所に限定します
    • pageSize（number、任意）：1 ページあたりの結果数（1～20）
    • pageToken（string、任意）：次のページの結果を取得するためのトークン
    • priceLevels（array、任意）：価格帯で絞り込みます
    • rankPreference（string、任意）："RELEVANCE" または "DISTANCE" で順位付けします
    • regionCode（string、任意）：2 文字の国／地域コード
    • strictTypeFiltering（boolean、任意）：タイプが完全に一致する結果のみを返します
    • evOptions（object、任意）：EV 充電ステーションのフィルター
    • minRating（number、任意）：評価の最低値で絞り込みます（0～5）
    • openNow（boolean、任意）：現在営業中の場所に絞り込みます
    • fields（array、任意）：レスポンスに含める特定のフィールド
  • 条件に一致する場所の詳細を返します

• places-nearby-search（近日公開）

  • 特定の場所の近くにある場所を検索します
  • 入力：
    • location（object、必須）：緯度と経度の座標
    • radius（number、任意）：検索半径（メートル）
    • keyword（string、任意）：結果を絞り込むキーワード
    • type（string、任意）：結果を絞り込む場所のタイプ
    • rankBy（string、任意）："prominence" または "distance" で順位付けします
    • openNow（boolean、任意）：現在営業中の場所に絞り込みます
    • fields（array、任意）：レスポンスに含める特定のフィールド
  • 近くにある場所の詳細を返します

• place-details（近日公開）

  • 特定の場所の詳細情報を取得します
  • 入力：
    • placeId（string、必須）：Google Place ID
    • fields（array、任意）：レスポンスに含める特定のフィールド
    • languageCode（string、任意）：結果の言語コード
  • 場所に関する包括的な詳細情報を返します

• place-photo（近日公開）

  • 場所の写真を取得します
  • 入力：
    • photoReference（string、必須）：Place Details のレスポンスに含まれる参照情報
    • maxWidth（number、任意）：返される画像の最大幅
    • maxHeight（number、任意）：返される画像の最大高さ
  • 写真データまたは URL を返します