mcpField
G
Google Maps Places

Google Maps Places

ローカル
github.com地図・旅行12 日前に更新
リポジトリ公式サイト

Google Maps Places について

Google Maps Places は、Google Places API で場所を検索し、写真を取得する MCP サーバーです。地域の店舗情報や住所確認が必要なワークフローに利用できます。

主な機能

  1. 01テキスト検索による場所の検索
  2. 02場所の写真 URL の取得

活用シーン

  1. 01場所や条件を指定してカフェを探す
  2. 02会議場所の情報を確認する
  3. 03不完全な住所を検証または補完する

MCP 対応

Google Places API を OAuth プロキシ経由で利用し、場所検索と写真取得のツールを MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "domdomegg-google-maps-places": {
      "command": "npx",
      "args": [
        "-y",
        "google-maps-places-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "<GOOGLE_ACCESS_TOKEN>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
      }
    }
  }
}
起動コマンドnpx -y google-maps-places-mcp
設定が必要な環境変数
GOOGLE_ACCESS_TOKENシークレットGoogle OAuth access token with cloud-platform scope.
MCP_TRANSPORTTransport type.
GOOGLE_CLIENT_IDGoogle OAuth client ID.
GOOGLE_CLIENT_SECRETシークレットGoogle OAuth client secret.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmgoogle-maps-places-mcp1.1.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

google-maps-places-mcp

Google Maps Places API 用の MCP サーバー。場所を検索して写真を取得できます。

使用例

ミーティングの調整：「オフィス近くの Nando's で会いましょう。都合のよい時間はいつですか？」というメールが届いた場合 → AI アシスタントが場所を調べ、営業時間を確認し、住所を添えてカレンダーに追加します。

近隣のおすすめ：「King's Cross 近くで、2時間の作業に使える静かな Wi-Fi 付きカフェを探して」と依頼 → 評価、営業時間、写真を参考に場所を選べます。

住所の確認：郵便物を送ったり配達を予約したりする前に、住所を確認したり、途中まで入力した住所を補完したりできます。

（これらは単なる例です。場所の検索や店舗情報が必要なワークフローなら、どのようなものでも利用できます。）

セットアップ

1. Google OAuth 認証情報を作成する
  1. Google Cloud Console にアクセスします
  2. 新しいプロジェクトを作成します（または既存のものを使用します）
  3. Places API (New) を有効にします
  4. APIs & Services → OAuth consent screen に移動し、同意画面を設定します
  5. APIs & Services → Credentials → Create Credentials → OAuth client ID に移動します
  6. Web application を選択します
  7. http://localhost:3000/callback を Authorized redirect URIs に追加します
  8. Client ID と Client Secret を控えておきます
2. サーバーを実行する
GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

サーバーはデフォルトで http://localhost:3000 で実行されます。PORT=3001 で変更できます。

3. MCP クライアントに追加する

サーバーを実行した状態で、install-mcp の手順に従ってください。MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

アーキテクチャ

このサーバーは、Google への OAuth プロキシとして動作します。

graph LR
    A[MCP client] <--> B[google-maps-places-mcp] <--> C[Google OAuth/API]
  1. サーバーは /.well-known/oauth-authorization-server を通じて OAuth 認可サーバーとして自身を公開します
  2. /register は Google OAuth クライアントの認証情報を返します
  3. /authorize はクライアントのコールバック URL を state に含めて Google にリダイレクトします
  4. /callback は Google からコードを受け取り、クライアントのコールバックに転送します
  5. /token はクライアントの認証情報を付与して、トークンリクエストを Google にプロキシします
  6. /mcp は MCP リクエストを処理し、ベアラートークンを使って Places API を呼び出します

サーバーはトークンも状態も保持せず、Google への OAuth をプロキシするだけです。

ツール

ツール説明
places_text_searchテキストクエリで場所を検索します（例：「近くのコーヒーショップ」）
places_photo_get場所の写真の URL を取得します

OAuth スコープ

  • cloud-platform - Google Cloud API へのアクセス（Places API New に必要）

コントリビューション

GitHub へのプルリクエストを歓迎します。始めるには、次の手順に従ってください。

  1. Git と Node.js をインストールします
  2. リポジトリをクローンします
  3. npm install で依存関係をインストールします
  4. npm run test を実行してテストを実行します
  5. npm run build でビルドします

リリース

バージョンはセマンティックバージョニング仕様に準拠します。

リリース手順：

  1. npm version <major | minor | patch> を使ってバージョンを更新します
  2. git push --follow-tags を実行してタグとともにプッシュします
  3. GitHub Actions が NPM レジストリに公開するまで待ちます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。