What is A2a Mcp Example

a2a_mcp-example is an example application demonstrating how to integrate A2A (Agent-to-Agent) and MCP (Model Context Protocol) to execute terminal commands using natural language queries.

Use cases

Use cases include deleting files, listing directory contents, and creating new directories on a Linux system, all through conversational commands.

How to use

To use a2a_mcp-example, clone the repository, set your OpenAI API key, create and activate a virtual environment, install the required packages, and start the UI, A2A, and MCP servers. Access the application via a web browser at http://localhost:12000.

Key features

Key features include the ability to execute terminal commands through simple English queries, integration with OpenAI’s GPT, and a user-friendly interface powered by FastAPI and Uvicorn.

Where to use

a2a_mcp-example can be used in various fields including software development, system administration, and educational environments where users need to interact with Linux systems using natural language.

🧠 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="<your-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