YouTubeリンク:A2AとMCPの詳細なステップバイステップチュートリアル、コードWalthroughも含まれます

これはLLM搭載のアプリケーションで、ユーザーは以下のような簡単な英語クエリを使ってターミナルコマンドを実行できます。

「デスクトップのreadme.txtを削除してください。」

Linuxシステム上でA2A*(エージェント間)およびMCP**(モデルコンテキストプロトコル)を活用してコマンドを解釈し実行します。

---

🛠️ 始めて

システムを稼働させるには以下の手順に従ってください。

1.リポジトリのクローン

2.Set OpenAI API Key

OpenAIのAPIキーを環境にエクスポートする:

3.仮想環境の作成と起動

4.設置要件

---

🧩 アプリケーションの実行

すべてのサービスが別々のターミナルタブやウィンドウで動作していることを確認してください:

🖥️ UIサーバーを起動

🔁 A2Aサーバーを起動

🖥️ MCPサーバーを起動

---

🌐 アプリケーションへのアクセス中

1. ブラウザを開き、次の場所へ行きます: http://localhost:12000
2. **エージェント*セクションへ移動。
3. 以下のエンドポイントを使ってLinuxエージェントを追加する:

これで自然言語でチャットやLinuxコマンドの実行を始める準備ができました!

---

🧪 例クエリ

• 「デスクトップ上のnotes.txtファイルを削除」

🧠 LLM-Powered Terminal Assistant using A2A & MCP

youtube link : Deep dive and step by step tutorial of A2A and MCP, including code walthrough

This is an LLM-powered application that allows users to execute terminal commands using simple English queries like:

“Delete readme.txt on my desktop.”

It leverages the A2A (Agent-to-Agent) and MCP (Model Context Protocol) to interpret and execute commands on a Linux system.

---

🛠️ Getting Started

Follow these steps to get the system up and running.

1. Clone the Repository

git clone https://github.com/ishanExtreme/a2a_mcp-example.git
cd a2a_mcp-example

2. Set OpenAI API Key

Export your OpenAI API key to your environment:

export OPENAI_API_KEY=""

3. Create and Activate Virtual Environment

python -m venv venv or conda create ...
source venv/bin/activate  # On Windows use: venv\Scripts\activate

4. Install Requirements

pip install -r requirements.txt

---

🧩 Running the Application

Ensure all the services are running in separate terminal tabs/windows:

🖥️ Start the UI Server

cd ./client/demo/ui
uv run main.py

🔁 Start the A2A Server

cd ./a2a_server
python main.py

🖥️ Start the MCP Server

cd ./mcp_server
python mcp_server.py

---

🌐 Accessing the Application

1. Open your browser and go to: http://localhost:12000
2. Navigate to the Agents section.
3. Add a Linux agent using the following endpoint:

http://localhost:10000

You are now ready to start chatting and executing Linux commands via natural language!

---

🧪 Example Queries

• “Delete the notes.txt file on Desktop”
• “List all files in the Documents folder”
• “Create a new directory called projects”

---

🧠 Built With

• OpenAI GPT
• A2A Protocol
• MCP Protocol
• FastAPI + Uvicorn
• Python 3.12+

---

📜 License

MIT License © 2025

---