mcpField
G
google-adk-mcp

google-adk-mcp

Local
github.com/nikhilpurwantDeveloper Tools7Updated 75w ago

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

  1. 01Build an agent with Google ADK
  2. 02Connect to the repairworld MCP server
  3. 03Create repair requests
  4. 04List repair requests
  5. 05View requests by ID
  6. 06Web and console interfaces

Use cases

  1. 01Learn how an agent calls external MCP tools
  2. 02Create repair requests through an agent
  3. 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.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

google-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:

  1. ✅ Use Google ADK (Agent Developer Kit) to build an agent.
  2. 🔌 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


🚀 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

Comments

Markdown supported

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.