google-adk-mcp について
google-adk-mcpは、Google ADKでAgentを構築し、repair_world_application向けのMCPサーバーに接続する方法を示すサンプルです。ADKとMCPの連携を学ぶ開発者向けで、ウェブとコンソールの実行方法があります。
主な機能
- 01Google ADKによるエージェント構築
- 02repairworld MCPサーバーへの接続
- 03修理依頼の作成
- 04修理依頼の一覧表示
- 05IDによる依頼の表示
- 06ウェブとコンソールのインターフェース
活用シーン
- 01エージェントによる外部MCPツール呼び出しを学習
- 02エージェント経由で修理依頼を作成
- 03ウェブUIまたはコンソールで依頼の一覧や詳細を確認
MCP 対応
エージェントはmcp-server-repairworldに接続し、修理依頼の作成、一覧表示、ID指定での表示に使うツールを呼び出します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
google-adk-mcp
🚀 外部 MCP サーバーを使用して修理 API とやり取りする Google ADK エージェントの構築方法を示すサンプルプロジェクトです(デモ専用に作成された repairworld application)。
このエージェントは、ブログ記事とデモ「26. The simplest MCP demo (Includes Sample provider app, MCP Server and Agent 🤖 code and explanation!)」に合わせて作成されています。
🧠 このプロジェクトでできること
このプロジェクトでは、次の方法を紹介します。
- ✅ Google ADK(Agent Developer Kit) を使ってエージェントを構築する。
- 🔌
repair_world_applicationの機能(修理リクエストの作成や表示など)を公開する既存の MCP サーバー にエージェントを接続する。
エージェントは、pypi リポジトリの MCP サーバー(mcp-server-repairworld)を使用します。
📦 前提条件
- Python 3.11+
- 起動中の repairworld application
🚀 使用方法
1. このリポジトリをクローンして Python 仮想環境を作成する
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. 依存関係をインストールする
pip install -r requirements.txt
3. エージェントを実行する(エージェント Web インターフェース)
repairworld application がすでに起動していることを確認してください。
http://localhost:8000 にアクセスすると、エージェント UI を利用できます。
adk web
または
3. エージェントを実行する(エージェントコンソールインターフェース)
repairworld application がすでに起動していることを確認してください。
python agent-repairworld.py
これで、エージェントは MCP サーバーが公開するツールを呼び出し、次の操作を実行できます。
🔧 修理リクエストを作成する
📄 すべての修理リクエストを一覧表示する
🔍 ID で修理リクエストを表示する
🛠 関連プロジェクト
- mcp-server-repairworld — repair_world_application とやり取りするためのツールを公開する MCP サーバーです。
- repair_world_application - 顧客が修理リクエストを作成できるアプリケーションです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。