Back to Home
XuYunlei icon

agentic-voice-assistant

Verified Safe

by XuYunlei

Overview

An agentic voice-to-voice product discovery assistant performing RAG and web searches over an Amazon product dataset to provide grounded answers.

Installation

Run Command
uvicorn mcp_server.server:app --reload --port 8000

Environment Variables

  • OPENAI_API_KEY
  • SEARCH_API_KEY
  • SEARCH_PROVIDER
  • EMBED_MODEL
  • GEN_MODEL
  • ASR_MODEL
  • TTS_PROVIDER
  • TTS_VOICE
  • INDEX_PATH
  • DATA_PRODUCTS
  • MCP_BASE

Security Notes

The server uses environment variables for API keys (e.g., OpenAI, Brave), preventing hardcoding of secrets. Input validation is provided by Pydantic models for FastAPI endpoints. External API calls (Brave, OpenAI TTS) use `httpx` with timeouts and error handling. The `critic` node includes basic safety checks. The MCP server is designed to run locally (127.0.0.1:8000), reducing direct external exposure risks. No 'eval' or malicious patterns were found. A minor potential improvement is to explicitly implement domain allowlisting for web search results as mentioned in `SAFETY.md`.

Similar Servers

Stats

Interest Score31
Security Score9
Cost ClassMedium
Avg Tokens3500
Stars1
Forks0
Last Update2025-11-21

Tags

AgenticVoice-to-VoiceRAGLangGraphProduct Search