README.md

metadata

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)

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