aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-17 22:24:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: google maps tutorial (#1353)

Browse Source
This commit is contained in:
Angie Jones
2025-02-24 08:04:13 -06:00
committed by GitHub
parent c5cc891b45
commit d786ecac61
10 changed files with 301 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
documentation/docs/tutorials/_template_.md
View File

@@ -28,6 +28,14 @@ This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
:::info
Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:
@@ -103,10 +111,10 @@ This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension
│ Command-line Extension
│
◇ What would you like to call this extension?
│ {name}}
│ {name}
│
◇ What command should be run?
│ {command}}
│ {command}
// highlight-start
◆ Would you like to add environment variables?
│ Yes

6
documentation/docs/tutorials/fetch-mcp.md
View File

@@ -24,13 +24,13 @@ uvx mcp-server-fetch
```
:::
## Configuration
:::info
Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
:::
## Configuration
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:

8
documentation/docs/tutorials/figma-mcp.md
View File

@@ -26,12 +26,12 @@ FIGMA_ACCESS_TOKEN: <YOUR_TOKEN>
```
:::
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
:::
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:

7
documentation/docs/tutorials/github-mcp.md
View File

@@ -24,12 +24,13 @@ GITHUB_PERSONAL_ACCESS_TOKEN: <YOUR_TOKEN>
```
:::
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
:::
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:

4
documentation/docs/tutorials/google-drive-mcp.md
View File

@@ -38,6 +38,10 @@ GDRIVE_OAUTH_PATH: ~/.config/gcp-oauth.keys.json
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
To obtain your Google Drive server credentials and oauth keys, follow the steps below:
1. Set up your Google Cloud Credentials, to enable API access:

268
documentation/docs/tutorials/google-maps-mcp.md Normal file
View File

@@ -0,0 +1,268 @@
---
title: Google Maps Extension
description: Add Google Maps MCP Server as a Goose Extension
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Google Maps MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps) as a Goose extension to enable geocoding, place searching, distance calculations, elevation data retrieval, and directions.
:::tip TLDR
**Command**
```sh
npx -y @modelcontextprotocol/server-google-maps
```
**Environment Variable**
```
GOOGLE_MAPS_API_KEY: <YOUR_TOKEN>
```
:::
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:
```sh
goose configure
```
2. Choose to add a `Command-line Extension`
```sh
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◆ What type of extension would you like to add?
│ ○ Built-in Extension
// highlight-start
│ ● Command-line Extension (Run a local command or script)
// highlight-end
│ ○ Remote Extension
└
```
3. Give your extension a name
```sh
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
// highlight-start
◆ What would you like to call this extension?
│ Google Maps
// highlight-end
└
```
4. Enter the command
```sh
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ Google Maps
│
// highlight-start
◆ What command should be run?
│ npx -y @modelcontextprotocol/server-google-maps
// highlight-end
└
```
5. Obtain a [Google Maps API Key](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in.
```sh
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ Google Maps
│
◇ What command should be run?
│ npx -y @modelcontextprotocol/server-google-maps
// highlight-start
◆ Would you like to add environment variables?
│ Yes
│
◇ Environment variable name:
│ GOOGLE_MAPS_API_KEY
│
◇ Environment variable value:
│ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
◇ Add another environment variable?
│ No
// highlight-end
└ Added github extension
```
</TabItem>
<TabItem value="ui" label="Goose Desktop">
1. Click `...` in the upper right corner
2. Click `Settings`
3. Under `Extensions`, click the `Add` link
4. On the `Add Extension Manually` modal, enter the following:
* **Type**: `Standard IO`
* **ID**: `google-maps-mcp` (_set this to whatever you want_)
* **Name**: `Google Maps` (_set this to whatever you want_)
* **Description**: `Google Maps API` (_set this to whatever you want_)
* **Command**: `npx -y @modelcontextprotocol/server-google-maps`
* **Environment Variables**
* **Name**: `GOOGLE_MAPS_API_KEY`
* **Value**: (_Obtain a [GOOGLE_MAPS_API_KEY](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in._)
* Click `Add` button
5. Click `Add Extension` button
</TabItem>
</Tabs>
## Example Usage
Goose acts as an autonomous agent that tracks a delivery driver’s location, updates the customer in real-time, and adjusts ETAs dynamically based on Google Maps traffic data.
Goose can:
**Monitor Driver Location**
* Goose gets the driver’s GPS coordinates every few seconds.
* If the driver’s location is significantly behind schedule, Goose recalculates the ETA.
**Traffic-Aware ETA Adjustments**
* Goose queries Google Maps for live traffic conditions.
* If delays are detected, Goose updates the customer’s tracker with a new estimated time.
**Dynamic Customer Notifications**
* If the driver is stuck in traffic, Goose sends an alert to the customer: “Your driver is running late due to traffic. Updated ETA: 7:25 PM.”
* If the driver is ahead of schedule, Goose notifies the restaurant to prepare the food earlier.
### Goose Prompt
```
Track the live GPS location of driver ID #12345. Query Google Maps for real-time traffic data and adjust the estimated delivery time if delays exceed 5 minutes. If ETA changes, update the customer’s live tracker and send an SMS notification. If the delay is greater than 20 minutes, check if another driver within a 1-mile radius can take over the delivery.
```
### Goose Output
:::note CLI
Okay, I will track Driver #12345, query Google Maps for traffic data, adjust the ETA, and notify the customer.
**Track Driver's GPS Location**
* **Driver ID:** #12345
* **Starting Point:** 1955 Broadway, Suite 600, Oakland, CA 94612
Driver #12345's movement:
```
2025-02-23 08:20:00: Latitude: 37.8074, Longitude: -122.2697 (Starting point)
2025-02-23 08:21:00: Latitude: 37.8080, Longitude: -122.2690
2025-02-23 08:22:00: Latitude: 37.8090, Longitude: -122.2680
2025-02-23 08:23:00: Latitude: 37.8100, Longitude: -122.2670
```
**Geocode Destination Address**
* **Customer Address:** 2111 Mission Street, San Francisco, CA
I will convert this address into geographic coordinates:
`─── maps_geocode | googlemaps ──────────────────────────`
address: 2111 Mission Street, San Francisco, CA
```
Latitude: 37.7631446
Longitude: -122.4192073
```
**Get Initial Directions and ETA**
I will get the initial route and ETA from the driver's starting point to the customer's address.
`─── maps_directions | googlemaps ──────────────────────────`
destination: 2111 Mission St, San Francisco, CA
mode: driving
origin: ...
```
Distance: 12.1 miles
Initial ETA: 21 minutes
Estimated arrival at: 08:41 AM
```
**Monitor Traffic and Adjust ETA**
I will monitor traffic updates and recalculate the ETA periodically.
```
Remaining Distance: 8 miles
Updated ETA: 15 minutes
Estimated arrival at: 08:45 AM
```
There is no significant delay.
*At 08:35 AM:* There's a traffic incident.
`─── maps_directions | googlemaps ──────────────────────────`
destination: 2111 Mission St, San Francisco, CA
mode: driving
origin: Latitude: 37.8100, Longitude: -122.2670
I apologize, I am unable to use the lat/long for the request. I will call google maps api with names instead.
`─── maps_directions | googlemaps ──────────────────────────`
destination: 2111 Mission St, San Francisco, CA
mode: driving
origin: ...
```
Remaining Distance: 7 miles
Updated ETA: 26 minutes
Estimated arrival at: 08:46 AM
```
The ETA has increased by 5 minutes from the original ETA of 08:41 AM. The directions now include a message: "Expect delays due to congestion."
**Update Customer and Send SMS**
[... other extensions used (e.g. Webhooks, MySQL, ClickSend)...]
* **Update Live Tracker:** The customer's live tracking interface is updated to reflect the new ETA of 08:46 AM.
* **Send SMS Notification:** _"Your delivery is now expected to arrive at approximately 08:46 AM due to traffic. We apologize for the inconvenience."_
:::

8
documentation/docs/tutorials/knowledge-graph-mcp.md
View File

@@ -20,12 +20,12 @@ npx -y @modelcontextprotocol/server-memory
```
:::
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
:::
## Configuration
:::info
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
:::
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command:

4
documentation/docs/tutorials/tavily-mcp.md
View File

@@ -24,12 +24,12 @@ TAVILY_API_KEY: <YOUR_API_KEY>
```
:::
## Configuration
:::info
Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
:::
## Configuration
<Tabs groupId="interface">
<TabItem value="cli" label="Goose CLI" default>
1. Run the `configure` command: