유튜브 링크 : A2A와 MCP에 대한 심층 및 단계별 튜토리얼, 코드 월루 포함

이 애플리케이션은 LLM 기반 애플리케이션으로, 사용자가 다음과 같은 간단한 영어 쿼리를 사용하여 터미널 명령을 실행할 수 있게 해줍니다:

“내 데스크톱에서 readme.txt를 삭제하세요.”

이 프로토콜은 A2A(에이전트 간 통신)와 MCP(모델 컨텍스트 프로토콜)를 활용하여 리눅스 시스템에서 명령을 해석하고 실행합니다.

---

🛠️ 시작하기

다음 단계를 따라 시스템을 가동하세요.

1. 저장소 복제

2. Set OpenAI API Key

OpenAI API 키를 환경으로 내보내세요:

3. 가상 환경 생성 및 활성화

4. 설치 요구사항

---

🧩 애플리케이션 실행 중

모든 서비스가 별도의 터미널 탭/창에서 실행되는지 확인하세요:

🖥️ UI 서버 시작

🔁 A2A 서버 시작

🖥️ MCP 서버 시작

---

🌐 애플리케이션 접근 중

1. 브라우저를 열고 [[T1]로 이동하세요.
2. 에이전트 섹션으로 이동하세요.
3. 다음 엔드포인트를 사용하여 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

---