MCP AI Agent with Google ADK, Google Maps, and Opik
@luuisotorres
About MCP AI Agent with Google ADK, Google Maps, and Opik
AI Agent built with Google ADK that leverages Google Maps MCP Server to answer real-world location questions with tool usage and traceable execution via Opik.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-ai-agent": {
"command": "uv",
"args": [
"venv",
"#",
"Create",
"a",
"virtual",
"environment",
"(e.g.,",
".venv)"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP AI Agent with Google ADK, Google Maps, and Opik?
This project demonstrates how to build an AI agent using the Google Agent Development Kit (ADK), OpenAI’s GPT‑4o model, the Google Maps MCP Server, and Opik for observability with CometML. It is designed for developers who want to learn agent development principles and see the Model Context Protocol (MCP) applied in practice.
How to use MCP AI Agent with Google ADK, Google Maps, and Opik?
Clone the repository, create a virtual environment with uv, install dependencies, and copy .env.example to .env with your API keys. Then run uv run adk web to start the ADK web UI at http://127.0.0.1:8000, where you can interact with the agent. The Google Maps MCP Server is started automatically via npx when needed.
Key features of MCP AI Agent with Google ADK, Google Maps, and Opik
- Built with Google Agent Development Kit (ADK)
- Uses OpenAI’s GPT‑4o model via LiteLLM
- Integrates Google Maps MCP Server for location tools
- Exposes seven Google Maps tools (directions, geocode, etc.)
- Traces all agent interactions with Opik in CometML
- Provides a web UI for debugging and conversation inspection
Use cases of MCP AI Agent with Google ADK, Google Maps, and Opik
- Get turn‑by‑turn driving, walking, or cycling directions
- Convert addresses to geographic coordinates and vice versa
- Retrieve elevation data for given coordinates
- Search for places (restaurants, landmarks) and get details
- Calculate travel time and distance between multiple points
FAQ from MCP AI Agent with Google ADK, Google Maps, and Opik
What are the prerequisites to run this project?
Python 3.11, uv (Python package manager), Node.js and npm/npx (to run the Google Maps MCP Server), and API keys for Google Maps Platform, OpenAI, and CometML.
How does the Google Maps MCP server start?
The ADK’s MCPToolset is configured to automatically start the server via npx when the agent needs to use its tools, so no manual startup is required.
Which Google Maps tools are available to the agent?
The agent can use: maps_directions, maps_geocode, maps_reverse_geocode, maps_elevation, maps_search_places, maps_place_details, and maps_distance_matrix.
Where are agent traces stored?
Traces are sent to CometML using the Opik observability library, which provides a rich UI to inspect LLM calls, tool usage, and overall agent behavior.
What AI model does the agent use?
The agent uses OpenAI’s GPT‑4o model, accessed through the LiteLLM integration within the Google ADK.
Frequently asked questions
What are the prerequisites to run this project?
Python 3.11, `uv` (Python package manager), Node.js and npm/npx (to run the Google Maps MCP Server), and API keys for Google Maps Platform, OpenAI, and CometML.
How does the Google Maps MCP server start?
The ADK’s `MCPToolset` is configured to automatically start the server via `npx` when the agent needs to use its tools, so no manual startup is required.
Which Google Maps tools are available to the agent?
The agent can use: `maps_directions`, `maps_geocode`, `maps_reverse_geocode`, `maps_elevation`, `maps_search_places`, `maps_place_details`, and `maps_distance_matrix`.
Where are agent traces stored?
Traces are sent to CometML using the Opik observability library, which provides a rich UI to inspect LLM calls, tool usage, and overall agent behavior.
What AI model does the agent use?
The agent uses OpenAI’s GPT‑4o model, accessed through the LiteLLM integration within the Google ADK.
Basic information
More AI & Agents MCP servers
🛡️ A.I.G（AI-Infra-Guard）
TencentA full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.
Sphere
dtajitdinov-arisOpen marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.
BlazingCDN MCP - Content Delivery for Video, Software & Static Files
BlazingCDNOfficial MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN
21st.dev Magic AI Agent
21st-devIt's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic
Hypnothera
La-SalidaAgent skill: turn what your AI assistant knows about you into a personalized hypnosis session on hypnothera.ai
Comments