G
Gcp Adk MCP Tools
by @nov05
MCP server by nov05
Created 4/8/2026
Updated about 4 hours ago
README
Repository documentation and setup instructions
🟢 Google Skills Lab - Use Model Context Protocol (MCP) Tools with ADK Agents
- Lab - https://www.skills.google/paths/3273/course_templates/1275/labs/606599
👉 Task 1. Install the ADK and set up your environment
git clone https://github.com/nov05/gcp-adk-mcp-tools.git
cd gcp-adk-mcp-tools
export PATH=$PATH:"/home/${USER}/.local/bin"
python3 -m pip install google-adk -r adk_mcp_tools/requirements.txt
👉 Task 2. Use the Google Maps MCP server with ADK agents (ADK as an MCP client) in the ADK Dev UI
Get an API key and enable the APIs
- Go to the Google Cloud console browser tab (not your Cloud Shell Editor).
Search forAPIsin the search bar at the top of the page. Select it from the results.
Go toAPIs & Services→Library, try enabling:Places API, and click+ Create Credential.
For Name, typeGOOGLE_MAPS_API_KEY. ClickCreate.
The API key created dialog displays your newly created API key. Be sure to copy and save this key locally for use later in the lab.
export GOOGLE_MAPS_API_KEY=AIzaSyAOGDeMSVXFEYml9PCpWM4hpTTQvWveoo4 # ⚠️ Your own key
cd ~/gcp-adk-mcp-tools/adk_mcp_tools
cat << EOF > google_maps_mcp_agent/.env
GOOGLE_GENAI_USE_VERTEXAI=TRUE
# GOOGLE_CLOUD_PROJECT=qwiklabs-gcp-03-ade964eda587
GOOGLE_CLOUD_LOCATION=global
# GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_API_KEY"
MODEL=gemini-3-flash-preview
EOF
cp google_maps_mcp_agent/.env adk_mcp_server/.env
cd ~/gcp-adk-mcp-tools/adk_mcp_tools
adk web --allow_origins "regex:https://.*\.cloudshell\.dev"
A new browser tab opens with the ADK Dev UI. From the Select an agent drop-down on the left, select the google_maps_mcp_agent. Start a conversation with the agent and run the following prompts:
Get directions from GooglePlex to SFO.
What's the route from Paris, France to Berlin, Germany?
How do you get from Shanghai to Seattle?
👉 Task 3. Build an MCP server with ADK tools (MCP server exposing ADK)
python3 ~/gcp-adk-mcp-tools/adk_mcp_tools/adk_mcp_server/adk_server.py
In a new terminal window:
export PATH_TO_YOUR_MCP_SERVER_SCRIPT="/home/$USER/gcp-adk-mcp-tools/adk_mcp_tools/adk_mcp_server/adk_server.py"
echo $PATH_TO_YOUR_MCP_SERVER_SCRIPT
cd ~/gcp-adk-mcp-tools/adk_mcp_tools
adk web --allow_origins "regex:https://.*\.cloudshell\.dev"
To view the web interface in a new tab, click the http://127.0.0.1:8000 link in the terminal output.
From the Select an agent drop-down on the left, select the adk_mcp_server.
Prompt the agent with the following:
Load the content from http://example.com
Quick Setup
Installation guide for this server
Install Package (if required)
uvx gcp-adk-mcp-tools
Cursor configuration (mcp.json)
{
"mcpServers": {
"nov05-gcp-adk-mcp-tools": {
"command": "uvx",
"args": [
"gcp-adk-mcp-tools"
]
}
}
}