README.md

---
title: Echo - Universal MCP Host
emoji: 🔊
colorFrom: gray
colorTo: gray
sdk: docker
pinned: false
tags:
  - mcp-in-action-track-consumer
  - agents
  - mcp
---

# Echo: The Universal MCP Host

**"Visualize the Invisible."**

Echo is a Neo-Brutalist, bidirectional Web Client for the Model Context Protocol (MCP). It acts as a "Universal Host" that can load any MCP Server and give it a UI.

## 🏆 Hackathon Submission (Track 2)
*   **Track**: MCP in Action (Consumer)
*   **Tag**: `mcp-in-action-track-consumer`

## 🚀 Key Features

### 1. Visual MCP Manager
Replacing `mcp.json` editing with a GUI.
*   **App Store Style**: Visualize your tools as cards.
*   **One-Click Connect**: Instant connection to MCP servers.
*   **Status Monitoring**: Real-time connection health.

### 2. Bidirectional State Protocol (Innovation)
Standard MCP is request/response. Echo introduces **Client State Broadcasting**.
*   **Protocol Inspector**: Visualize JSON-RPC traffic in real-time.
*   **Blocking State**: Echo broadcasts when it is blocked (e.g., waiting for user confirmation).
*   **Proactive Voice**: Connected AgentBell servers can listen for this state and speak *before* acting.

### 3. Universal Host
Echo is server-agnostic.
*   It connects to `stdio` servers (like `server-memory`).
*   It connects to python servers (like `agentbell`).
*   It provides a standard LLM interface (OpenAI) to interact with tools.

---

## 🛠️ How to Use

1.  **Enter your OpenAI API Key** in the settings (or via Environment Variable).
2.  **Go to TOOLS**: See available servers.
3.  **Click Connect** on "agentbell-voice".
4.  **Go to SESSION**: Chat with the agent.
    *   Try: "Help me"
    *   Try: "Delete file test.txt" (Triggers Blocking State -> Inspector Highlight)
5.  **Open INSPECTOR**: Watch the JSON-RPC traffic live.

---

## 📦 Setup (Local)

```bash
git clone https://huggingface.co/spaces/MCP-1st-Birthday/echo-agent
cd echo-agent
pip install -r requirements.txt
python app.py
```