mcp server
EchoSight-AI
A real-time walking guide for the blind. It looks through your phone camera to alert you of obstacles in your path, navigates you through doors, tracks where you kept personal items, and describes you
Set up
Runs on your computer. Pick your agent and operating system.
This project does not publish an install method we can turn into a config. Follow the README instead.
README
synced Oct 29, 2026👁️ EchoSight
100% Hands-Free Voice-First Spatial & Visual Co-Pilot for the Blind & Low-Vision
Real-Time Collision Radar • 3D Spatial Memory Registry • Model Context Protocol (MCP) • Alexa+ Track
"Sight is not just photons hitting a retina—it is freedom, spatial confidence, and the dignity to walk into the unknown without fear. EchoSight does not just describe the world; it guides your footsteps through it."
📑 Table of Contents
- The Problem: The Dangerous Paradox of Modern Assistive Tech
- The Solution: 100% Hands-Free Autonomous Co-Pilot
- Target Audience & Beneficiaries
- 100% Hands-Free, Eyes-Free Experience
- The Alexa+ Track: Eyes for the Next Generation of Voice AI
- Visual Showcase & System Tour
- Core Capabilities & Feature Deep-Dive
- Technical Architecture & MCP Implementation
- Tech Stack
- Quick Start & Setup Instructions
- Acknowledgments
🚨 The Problem: The Dangerous Paradox of Modern Assistive Tech
Over 2.2 billion people live with visual impairment or blindness across the globe. In an era where artificial intelligence can diagnose rare diseases and compose symphonies, the day-to-day reality for a blind person navigating their own home or a crowded street remains fraught with physical danger and cognitive exhaustion.
Existing assistive technologies suffer from three critical systemic failures:
┌─────────────────────────────────────────────────────────────────────────────┐
│ THE ASSISTIVE TECHNOLOGY PARADOX │
├────────────────────────┬────────────────────────────────────────────────────┤
│ 1. The Touchscreen │ Most "vision apps" are visual smartphone apps with │
│ Trap │ accessibility bolted on as an afterthought. Blind │
│ │ users are forced to tap flat, featureless glass │
│ │ screens, dismiss modals, and hunt for buttons. │
├────────────────────────┼────────────────────────────────────────────────────┤
│ 2. The Poetic Caption │ When facing a hazard, generic multimodal models │
│ Failure │ output 60-word poetic captions ("A well-lit room │
│ │ with ceramic tiles and modern furniture..."). A │
│ │ blind person does not need poetry; they need: │
│ │ "Stop! Wall directly ahead." │
├────────────────────────┼────────────────────────────────────────────────────┤
│ 3. The Spatial Memory │ Losing a white cane, keys, smartphone, or medicine │
│ Black Hole │ turns a home into a minefield. Once an object leaves│
│ │ physical touch, it effectively ceases to exist. │
└────────────────────────┴────────────────────────────────────────────────────┘
When walking blind, latency is not an annoyance—it is a collision. A 3-second delay in warning someone about a closed door, downward stairwell, or low coffee table results in real physical trauma.
💡 The Solution: 100% Hands-Free Autonomous Co-Pilot
EchoSight re-imagines assistive vision from the ground up as a 100% eyes-free, voice-operated spatial companion.
EchoSight transforms standard camera hardware into a real-time sensory radar that acts like a vigilant, sighted companion walking beside you:
- Urgent Collision Radar: Analyzes footsteps and walking vectors at an adaptive 2.5-second cadence, giving crisp, authoritative directional cues ("Hold on. Stop right there, wall directly ahead.", "Doorway ahead, step through carefully into the room.").
- 3D Spatial Memory Registry: Allows users to casually pin personal objects in spatial memory ("Remember where my keys are"), anchoring items relative to physical room landmarks and guiding users back to them on demand.
- Instant Conversational Barge-In: Real-time conversational interruption allows users to speak over EchoSight mid-sentence to ask urgent questions or halt commands without waiting for audio playback to finish.
- Zero UI Touch Dependency: From startup greeting to camera switches, live scans, photo captures, and deep chart analysis, every single action is 100% hands-free and voice-driven.
🎯 Target Audience & Beneficiaries
EchoSight is engineered specifically for users who cannot rely on visual interfaces:
- Totally Blind Individuals: Users who require real-time audio guidance to navigate indoor corridors, avoid collisions with open cabinet doors, and safely cross thresholds.
- Low-Vision & Legally Blind Navigators: Individuals with macular degeneration, glaucoma, or severe diabetic retinopathy who need proactive high-contrast verbal cues and text transcription.
- Visually Impaired Students & Professionals: Knowledge workers who need exhaustive visual deconstruction of complex infographics, financial charts, documents, and sports scorecards without visual assistance.
- Elderly Individuals with Degenerative Vision Loss: Seniors who find smartphone touchscreens confusing or inaccessible and benefit from pure conversational voice commands.
🎙️ 100% Hands-Free, Eyes-Free Experience
┌────────────────────────────────────────────────────────────────────────┐
│ ZERO TOUCHSCREEN INTERACTION REQUIRED │
│ │
│ 🗣️ "Enter" ──► Unlocks audio gateway & greets user │
│ 🗣️ "Start Surroundings" ──► Activates walking radar & camera stream │
│ 🗣️ "Can I move forward?"──► Instant sub-50ms walking path clearance │
│ 🗣️ "Remember my keys" ──► Pins item 3D landmark to spatial memory │
│ 🗣️ "Where are my keys?" ──► Directional audio navigation to item │
│ 🗣️ "Take a photo" ──► Captures freeze-frame inspection │
│ 🗣️ "Analyze it" ──► Exhaustive visual data breakdown │
│ 🗣️ "Stop" ──► Instantly kills camera stream & audio │
└────────────────────────────────────────────────────────────────────────┘
In EchoSight, the voice is the interface. The application features an automatic auditory handshake on launch:
- It speaks its welcome greeting aloud: "EchoSight. Voice-First Spatial and Visual Co-Pilot. Say Enter or tap anywhere to begin."
- The user says "Enter", and the system immediately transitions to the cockpit.
- Users never need to touch the phone screen, search for UI controls, or adjust sliders.
⚡ The Alexa+ Track: Eyes for the Next Generation of Voice AI
As voice assistants evolve into agentic, proactive companions under Alexa+, the missing link has always been physical vision and spatial grounding. Traditional voice assistants are disembodied brains that can tell you the weather or set a timer, but cannot see the door you are about to walk into or remember which table you placed your glasses on.
EchoSight serves as the definitive reference implementation for Alexa+ Spatial Intelligence:
- Model Context Protocol (MCP) Architecture: EchoSight exposes its visual cortex as standardized MCP tools running over Streamable HTTP/SSE (Server-Sent Events) and Stdio. Any Alexa+ agent can dynamically invoke EchoSight tools to inspect surroundings, pin objects, or verify walking paths.
- Proactive Conversational Autonomy: EchoSight does not just answer when spoken to; its active radar proactively interrupts when an imminent obstacle appears, matching the conversational agency championed by Alexa+.
- Decoupled Safety & Context Loops: Urgent safety checks run on a priority cadence (2.5s), while ambient contextual descriptions run in the background (12–30s), ensuring conversational breadth never compromises real-time human safety.
📸 Visual Showcase & System Tour
🚀 Core Capabilities & Feature Deep-Dive
1. Real-Time Walking Radar (Dual-Tier Safety Architecture)
- Sub-Second Path Safety: Evaluates forward walking vectors at an adaptive 2.5-second cadence (utilizing multi-key pooling) or 5-second baseline.
- Fail-Safe Decision Normalization: If a visual frame is blurry, timed out, or ambiguous, EchoSight never defaults to "clear". It strictly announces: "Stop. Path not verified."
- Directional Threshold & Doorway Guidance: Detects openings and doorways off-axis: "Stop, wall directly in front of you. The doorway is to your right—turn right."
2. 3D Spatial Memory & Permanent Landmark Pinning
- Object Anchoring: Point the camera at any personal item and say "Remember where my keys are". EchoSight anchors the item relative to permanent room structures ("Pinned your keys on the wooden desk, two feet to the right of the laptop").
- Conversational Retrieval: Asking "Where did I put my keys?" searches the spatial registry and cross-references live camera frames to provide directional guidance back to the object.
3. Sub-50ms Cached Navigation Q&A
- When a user asks "Can I move forward?" or "Where should I walk?" while the radar is running, EchoSight checks its fresh (<3000ms) safety state and answers instantly in under 50 milliseconds, bypassing external API round-trips for immediate walking confidence.
4. Instant Conversational Barge-In Interruption
- Speech synthesis is integrated with full acoustic echo suppression and continuous listening. The millisecond a user utters a syllable or command like "Stop", all ongoing system audio cuts off instantly to prioritize user input.
5. Exhaustive Multimodal Visual Breakdown
- Beyond rapid navigation, users can say "Take a photo" and "Analyze it" to receive patient, structured breakdowns of documents, medicine packaging, complex financial infographics, and sports scorecards.
6. Hardware-Level Camera Teardown
- Saying "Stop", "Stop camera", or "Turn off camera" immediately terminates all active video tracks and shuts off camera sensor hardware, preserving device battery and user privacy.
🏗️ Technical Architecture & MCP Implementation
EchoSight implements the Model Context Protocol (MCP) specification (2025-11-25+), allowing client applications and AI agents to invoke specialized sensory tools over streamable transports:
flowchart TD
subgraph Client ["Client Layer (React 19 + TypeScript)"]
UI["Voice Co-Pilot Unified Cockpit"]
STT["Web Speech Recognition (Continuous Barge-In)"]
TTS["Web Speech Synthesis (Priority Interrupt)"]
VStream["Constrained Video Stream (640px JPEG 0.70)"]
end
subgraph MCPClient ["Client MCP Service (mcpClient.ts)"]
ToolRouter["Tool Invocation & Timeout Manager"]
SafetyCache["Sub-50ms Safety Decision Cache"]
end
subgraph MCPServer ["MCP Server (Node.js + Express + TypeScript)"]
SSE["Streamable HTTP / SSE Transport (/sse)"]
Stdio["Stdio Transport (--stdio)"]
Pool["Multi-Key Rotation Pool (Rolling Rate Limiting)"]
Deadline["Hard Timeout Deadlines (4s / 12s)"]
end
subgraph VisionEngine ["Multimodal Reasoning Engine"]
G35["Multimodal Vision Intelligence"]
Normalizer["Safety Normalizer & Ground Truth Gate"]
end
UI --> STT
STT --> ToolRouter
VStream --> ToolRouter
ToolRouter --> SafetyCache
ToolRouter --> SSE
SSE --> Pool
Stdio --> Pool
Pool --> Deadline --> G35
G35 --> Normalizer
Normalizer --> ToolRouter
ToolRouter --> TTS
Official MCP Tool Registry
| Tool Name | Transport | Purpose | Output Format |
|---|---|---|---|
describe_surroundings | SSE / Stdio | Live camera surroundings & hazard radar | Spoken spatial cues + directional insights |
check_walking_path | SSE / Stdio | Sub-second collision avoidance check | Normalized safety state (clear, stop, slow, etc.) |
pin_spatial_object | SSE / Stdio | Anchors object relative to permanent room landmarks | JSON Landmark schema + spoken confirmation |
locate_spatial_object | SSE / Stdio | Searches spatial memory & cross-checks live camera | Directional audio navigation to item |
analyze_visual | SSE / Stdio | Exhaustive visual breakdown of charts, maps, scenes | Structured multi-paragraph analysis |
analyze_video | SSE / Stdio | Chronological narration of recorded video clips | Continuous narrative breakdown |
analyze_scorecard | SSE / Stdio | Sports scorecard analysis & match momentum | Voice summary of wickets, runs, and rates |
ask_followup | SSE / Stdio | Conversational Q&A grounded in live context | Punchy conversational response |
ping | SSE / Stdio | Protocol handshake and uptime diagnostic | Health confirmation & session count |
💻 Tech Stack
Frontend Client
- Framework: React 19.3 with TypeScript (Strict Mode)
- Bundler & Tooling: Vite 8.3 with
@tailwindcss/vite - Styling: Tailwind CSS 4.3 with custom glassmorphism design tokens
- Icons: Lucide React
- Speech Engine: Native Web Speech API (
SpeechRecognition&SpeechSynthesis) with continuous barge-in and echo cancellation
Backend MCP Server
- Runtime: Node.js v22+ / v24+
- Server Framework: Express 4.21 with CORS
- Protocol SDK:
@modelcontextprotocol/sdk(Model Context Protocol official SDK) - Validation: Zod 3.24 schema validation
- Transport Modes: Streamable HTTP / Server-Sent Events (SSE) on
/sseand Stdio transport via--stdio
Vision & AI Models
- Primary Vision Engine: High-speed multimodal spatial vision model
- Key Pool Management: Server-side multi-key project pool with rolling 60-second window request tracking and automatic rotation
- Audio Intelligence Backup: High-speed speech-to-text fallback
🛠️ Quick Start & Setup Instructions
Prerequisites
- Node.js: v18.0.0 or higher (v22+ recommended)
- npm: v9.0.0 or higher
- Vision Intelligence API Credentials
1. Clone the Repository
git clone https://github.com/Manthan-cpp/EchoSight-AI.git
cd EchoSight-AI
2. Configure Environment Variables
Set up your server configuration in the server/ directory with your preferred server port and vision credentials.
3. Install Dependencies & Build
# Install and build MCP server
cd server
npm install
npm run build
cd ..
# Install and build web client
cd client
npm install
npm run build
cd ..
4. Run Locally
Open two terminal windows:
Terminal 1: Start MCP Server
cd server
npm start
# Server listens on http://localhost:3001 (SSE on /sse, Health on /health)
Terminal 2: Start Web Client
cd client
npm run dev
# Vite dev server live at http://localhost:5173
5. Inspecting MCP Tools via Official Inspector
You can verify and test all 8 MCP tools using Anthropic's official MCP Inspector:
cd server
npm run inspector
🏆 Acknowledgments
- Amazon Alexa+ Team: For inspiring the voice-first paradigm and agentic spatial intelligence.
- Model Context Protocol (MCP) Community: For establishing open standards for LLM-tool connectivity.
- Multimodal Vision & AI Researchers: For high-speed sensory vision models making real-time accessibility possible.
- Open Source Accessibility Advocates: Dedicated to building tools that ensure technology leaves no one behind.
EchoSight — Giving Voice to Vision.
Built with ❤️ for the Alexa+ Track Hackathon 2026.