my-adk-base-agent-with-MCP

A base ReAct agent built with Google's Agent Development Kit (ADK) Agent generated with googleCloudPlatform/agent-starter-pack version 0.3.5 and integrated with googleapis/genai-toolbox

Simple agent for local testing and prototyping.

Project Structure

This project is organized as follows:

my-adk-base-agent/
├── app/                 # Core application code
│   ├── agent.py         # Main agent logic
│   ├── agent_engine_app.py # Agent Engine application logic
│   └── utils/           # Utility functions and helpers
├── Makefile             # Makefile for common commands
└── pyproject.toml       # Project dependencies and configuration

The create agent starter pack will generate also the following folders. ├── deployment/ # Infrastructure and deployment scripts ├── notebooks/ # Jupyter notebooks for prototyping and evaluation ├── tests/ # Unit, integration, and load tests

Requirements

Before you begin, ensure you have:

• uv: Python package manager - Install
• Google Cloud SDK: For GCP services - Install
• Terraform: For infrastructure deployment - Install
• make: Build automation tool - Install (pre-installed on most Unix-based systems)
• MCP Toolbox: MCP Toolbox - Install (pre-installed on most Unix-based systems)
• Alloydb Auth Proxy: Alloydb Proxy

Quick Start (Local Testing)

Install required packages and launch the local development environment:

python -m venv .venv
source .venv/bin/activate    
pip install google-adk langchain toolbox-langchain agent-starter-pack uv
make install 
start_stop_services.sh start
make playground

This is an snapshot of the assistant: