はじめに

バージョン 0.4.0 は、ターミナルまたは MCP クライアントから利用できる 42 ツールを 1 つの実行ファイルで提供します。本マニュアルは、インストール、Google の認証設定、ツールの全インターフェースを説明します。

リポジトリの作業ディレクトリでビルド：

cargo install --path . --locked

インストール

Linux x86_64、macOS Apple Silicon、macOS Intel のビルド済みバイナリを GitHub Releases で公開しています。環境に合うアーカイブをダウンロードし、SHA256SUMS と照合してから展開し、mcp-gmap-rs を PATH に置いてください。Linux バイナリには glibc 2.35 以降が必要です。macOS バイナリは署名・公証されていません。

Rust 1.88 以降では crates.io からインストールできます。

cargo install mcp-gmap-rs --version 0.4.0 --locked
mcp-gmap-rs --version

ビルド後の実行には Rust、Python、JavaScript のランタイムは不要です。ホストには CA 証明書、DNS、Google への外向き HTTPS 接続が必要です。

認証情報の設定

制限付きキーを作成してサービスを有効化するか、サービスアカウントの OAuth を設定します。作業ディレクトリ内の Git 管理対象外の .env に認証情報を保存します。

GOOGLE_MAPS_AUTH_MODE=api-key
GOOGLE_MAPS_API_KEY=your-restricted-api-key

環境変数はファイルの値を上書きします。認証情報をバージョン管理やイメージ層に含めないでください。.env は親ディレクトリを検索しないため、作業ディレクトリに注意してください。

検出、確認、呼び出し

ツール検出とオフライン診断は Google にリクエストを送信しません。

mcp-gmap-rs tools
mcp-gmap-rs schema search-places
mcp-gmap-rs doctor

続いて、料金が発生する可能性のある最初の呼び出しを実行します。

mcp-gmap-rs search-places --query 'coffee near Gare de Lyon, Paris'

結果は JSON です。返された場所 ID を保存して詳細取得に再利用し、同じ名前を何度も解決しないようにします。自動化には CLI の使い方、エージェント接続には MCP 統合を参照してください。活用例ではツールの組み合わせ、完全なリファレンスではすべての引数・既定値・結果を説明しています。