gemini-search-agent
MukundaKatta/gemini-search-agent
NL-to-Elasticsearch search agent on Google Cloud Agent Builder (ADK) + Gemini 2.5 + Elastic MCP. Apache-2.0.
Instalação
npx convez-ai MukundaKatta/gemini-search-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
gemini-search-agent
A natural-language Elasticsearch search agent built on Google Cloud Agent Builder (ADK), Gemini 2.5, and the Elastic MCP server.
Live demo: https://gemini-search-agent-1029931682737.us-central1.run.app Demo video: https://youtu.be/ZZMm5ujYnJ8 (1:39) License: Apache 2.0
What it does
You ask "how many ERROR-level logs are there, and which service is the
worst offender?" or "find me products under $200 that are in stock and
rated above 4.5." The agent walks the Elastic MCP tools (list_indices,
get_mappings, search, count_errors), runs the right query, and
answers with counts and document IDs copied verbatim from the cluster's
response.
The agent uses the same tool surface as the official
@elastic/mcp-server-elasticsearch
npm package + Docker image. A stub MCP server ships with the repo so
demos run without a live cluster (a canned 482-document log index plus a
small products index).
Try it locally
git clone https://github.com/MukundaKatta/gemini-search-agent
cd gemini-search-agent
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
gcloud auth application-default login
export GOOGLE_CLOUD_PROJECT=your-project
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_LOCATION=us-central1
PYTHONPATH=src streamlit run app/dashboard.py
Try it against a real Elasticsearch cluster
export ES_URL="https://your-cluster.es.region.gcp.elastic-cloud.com"
export ES_API_KEY="..."
Untick "Use stub Elastic MCP" in the sidebar. The agent now spawns the official Elastic MCP docker image via Docker.
Tests
PYTHONPATH=src pytest -q
12 tests cover the stub server's responses and the agent wiring.
License
Apache 2.0. Mukunda Katta, independent developer.