File size: 2,000 Bytes
d387e95
85dd3af
 
 
e3c2a71
2bb2438
d387e95
85dd3af
 
 
 
d387e95
 
85dd3af
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2bb2438
85dd3af
2bb2438
 
85dd3af
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
---
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
```