Google-ADK-with-MCP-Flight-Stats

# Simple ADK Agent that plugs into MCP Server This is a Simple Agent built with the [Google Agent Development Kit](https://google.github.io/adk-docs/) that plugs into an MCP Server. There is no authentication or security. The two pieces - Agent and MCP Server - are implemented as two regular apps, implemented in python. They can both be run locally. One is the agent, the other is a simple MCP server that the agent connects to. ## Prerequisities and Setup You need Python3. And credentials to use TomTom, OpenSky, and Gemini . To work on it for the first time: 1. Set your python environment: ``` python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt ``` 2. Create a .env file with contents like this: ``` TOMTOM_API_KEY=xxyyyzz OSKY_CLIENT_ID=email@example.com-api-client OSKY_CLIENT_SECRET=xxxyyyyzzhzhhdhd GOOGLE_API_KEY=aasssbbbbcccccddde-elekel ``` You will need to obtain credentials for these services by visiting: - https://developer.tomtom.com/ - https://opensky-network.org/ - https://ai.studio ## Running it 1. Start the MCP Server first. It will listen on localhost, port 9240 ``` dotenv run python3 mcp-server/main.py ``` 2. Run the agent (again, locally), as a web app, with a UI ``` dotenv run adk web -v ./agent/agents ``` Then visit http://localhost:8000 , from a local browser. You can then interact with the agent. Ask it questions like: - Tell me about the current air traffic around Charlotte, NC; specifically What airlines have the most flights there, _and how many flights_ do these airlines have? Also include the number of flights with no registered call sign, or a callsign that cannot be resolved to an airline. Format the results in a table, and give a Total of flight counts in the last row of the table. - Compare the currently observed aircraft flight activity for Chicago, Seattle, Charlotte, and Dallas, at this moment. ## For the Reader - You can deploy either or both to Cloud Run. If you do that you need to modify the MCP endpoint in the agent code. - You can insert logic in the Agent to use access tokens for the MCP server ## Disclaimer This example is not an official Google product, nor is it part of an official Google product. ## Support This callout is open-source software, and is not a supported part of Apigee. If you need assistance, you can try inquiring on [the Google Cloud Community](https://discuss.google.dev/) forum. There is no service-level guarantee for responses to inquiries posted to that site. ## License This material is [Copyright © 2025 Google LLC](./NOTICE). and is licensed under the [Apache 2.0 License](LICENSE).