About google-adk-mcp
google-adk-mcp is a sample project showing how to build a Google ADK agent that connects to an MCP server for repair_world_application. It is for developers learning ADK and MCP integration, and provides both a web interface and a console option.
Key features
- 01Build an agent with Google ADK
- 02Connect to the repairworld MCP server
- 03Create repair requests
- 04List repair requests
- 05View requests by ID
- 06Web and console interfaces
Use cases
- 01Learn how an agent calls external MCP tools
- 02Create repair requests through an agent
- 03View request lists and details in the web UI or console
MCP support
The agent connects to mcp-server-repairworld and invokes its tools for creating repair requests, listing them, and viewing a request by ID.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEgoogle-adk-mcp
🚀 Sample project demonstrating how to build a Google ADK agent that uses an external MCP server to interact with a repair API (repairworld application - created specifically for the demo).
This agent is created to go along with the blog post and demo - 26. The simplest MCP demo (Includes Sample provider app, MCP Server and Agent 🤖 code and explanation!)
🧠 What This Project Does
This project shows how to:
- ✅ Use Google ADK (Agent Developer Kit) to build an agent.
- 🔌 Connect that agent to an existing MCP server that exposes functionality of the
repair_world_application(e.g., creating and viewing repair requests).
The agent uses MCP server from the pypi repo - mcp-server-repairworld.
📦 Prerequisites
- Python 3.11+
- A running repairworld application.
🚀 How to Use
1. Clone this repo create python virtual environment
git clone https://github.com/your-username/google-adk-mcp.git
cd google-adk-mcp
# create python virtual environment
python -m venv .venv
. .venv/bin/activate # on windows do .venv\Scripts\activate
2. Install dependencies
pip install -r requirements.txt
3. Run the agent (Agent Web Interface)
Make sure you already have the running repairworld application.
Go to http://localhost:8000 to access the Agent UI
adk web
OR
3. Run the agent (Agent Console Interface)
Make sure you already have the running repairworld application.
python agent-repairworld.py
The agent should now be able to invoke tools exposed by the MCP server to:
🔧 Create a repair request
📄 List all repair requests
🔍 View a repair request by ID
🛠 Related Projects
- mcp-server-repairworld — MCP server that exposes tools for interacting with the repair_world_application.
- repair_world_application - An application allowing customers to create repair requests
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.