IA

ishanextreme/a2a_mcp-example

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

183 stars 45 forks Качество 39 Тренд 17

ishanextreme/a2a_mcp-example — это кандидат MCP-сервера, импортированный из https://github.com/ishanextreme/a2a_mcp-example.

Обзор

ishanextreme/a2a_mcp-example — это кандидат MCP-сервера, импортированный из https://github.com/ishanextreme/a2a_mcp-example.

Обзор (машинный перевод)

ссылка на youtube: Глубокое погружение и пошаговое обучающее обучение по A2A и MCP, включая код Walthrough

Это приложение на базе LLM, которое позволяет пользователям выполнять команды терминала с помощью простых английских запросов, таких как:

«Удалить readme.txt с моего рабочего стола.»

Он использует A2A (Agent-to-Agent) и MCP (Протокол контекста модели) для интерпретации и выполнения команд на системе Linux.


🛠️ Начало

Следуйте этим шагам, чтобы система заработала.

1. Клонирование хранилища

2. Установить ключ API OpenAI

Экспортируйте ваш ключ OpenAI API в вашу среду:

3. Создание и активация виртуальной среды

4. Требования к установке


🧩 Запуск приложения

Убедитесь, что все сервисы работают в отдельных терминальных вкладках/окнах:

🖥️ Запустить сервер интерфейса

🔁 Запустить сервер A2A

🖥️ Запустить сервер MCP


🌐 Доступ к приложению

  1. Откройте браузер и перейдите на: http://localhost:12000
  2. Перейдите в раздел Агенты.
  3. Добавить Linux-агент с помощью следующего конечного устройства:

Теперь вы готовы начать общаться и выполнять команды Linux на естественном языке!


🧪 Примеры запросов

  • «Удалить файл notes.txt на рабочем столе»

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

🧠 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


Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →