MCP AI Agent with Google ADK, Google Maps, and Opik

Name: MCP AI Agent with Google ADK, Google Maps, and Opik
Author: luuisotorres

@luuisotorres

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.

#python #mcp #artificial-intelligence #openai #google-maps-api #ai-agents #opik #comet-ml #ai-agent #llm-agent #llm-tools #gpt-4o #model-context-protocol #mcp-server #model-context-protocol-servers #adk-python

基本情報

カテゴリ

AI とエージェント

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

luuisotorres

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-ai-agent": {
      "command": "uv",
      "args": [
        "venv",
        "#",
        "Create",
        "a",
        "virtual",
        "environment",
        "(e.g.,",
        ".venv)"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

「AI とエージェント」の他のコンテンツ

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797