JUHE API Marketplace
AtulanZaman avatar
MCP Server

ADK MCP Agent

A streaming chat agent that integrates Google ADK with Model Context Protocol and Google Maps tools, enabling users to interact with location-based services through a conversational interface.

0
GitHub Stars
8/23/2025
Last Updated
No Configuration
Please check the documentation below.

README Documentation

ADK MCP Agent

A streaming chat agent using Google ADK and the Model Context Protocol (MCP) Google Maps toolset.

Local Development

  1. Install dependencies:

    pip install -r requirements.txt
    
  2. Set up .env in app/ with your API keys.

  3. Run locally:

    export SSL_CERT_FILE=$(python -m certifi)
    uvicorn app.main:app --reload
    

Project Structure

adk-mcp-agent/
├── app/
│   ├── main.py
│   ├── static/
│   │   └── index.html
│   └── .env
├── agent/
│   └── agents.py
├── requirements.txt
├── Dockerfile
├── README.md
└── .gitignore
  • The agent logic is in the agent/ directory (agent/agents.py).
  • The FastAPI app and UI are in the app/ directory.

Deployment

To test and run the app locally with the UI:

  1. Install dependencies:

    pip install -r requirements.txt
    
  2. Set up environment variables:

    • Create a .env file inside the app/ directory with your API keys:
      GOOGLE_GENAI_USE_VERTEXAI=FALSE
      GOOGLE_API_KEY=your_genai_api_key
      GOOGLE_MAPS_API_KEY=your_google_maps_api_key
      
  3. Run the FastAPI app:

    export SSL_CERT_FILE=$(python -m certifi)
    uvicorn app.main:app --reload
    
  4. Access the UI:

    • Open your browser and go to http://localhost:8000
    • You can now interact with the chat interface and test the agent locally.

License

MIT

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source