How mohan-c0des/mcp_alexa works
Alexa+ Laptop Assistant is a local MCP server for screen interaction, safe file chores, data analysis, research, and file discovery, with simulated web and terminal clients. The main workflow is user request → client-side agent → MCP server tool → result; higher-risk screen and file changes add approval and undo stages. Analysis and research can produce PDF reports. The README documents these capabilities, while excerpts show server registration and selected tool behavior; unsampled tool internals and the separate productivity automation module are represented conservatively.
Main entry points: server.py MCP server · analyze_data.py Data analysis · research_topic.py Web research · script_writer.py Script preview and undo
Components 16
Simulated clients
- Web interface
client/Simulated_frontend/src/App.jsx - Web app entry
client/Simulated_frontend/src/main.jsx - Web API
client/Simulated_backend/main.py - Terminal agent
client/Simulated_backend/agent.py
MCP orchestration
- Agent orchestration
client/Simulated_backend/main.py - Tool guidance
instructions.py - MCP server
server.py
Screen and files
- Screen control
tools/screen_control.py - File discovery
tools/fs_tools.py
Analysis and research
- Data analysis
tools/analyze_data.py - Web research
tools/research_topic.py - PDF rendering
tools/pdf_utils.py
Safe changes
- Script preview and undo
tools/script_writer.py - Script sandbox
tools/sandbox_runner.py - Productivity automations
extra_productivity/automations.py
Other components
- User
Connections 19
- User → Web interface: requests
README.md - User → Terminal agent: requests
README.md - Web app entry → Web interface: renders
client/Simulated_frontend/src/main.jsx - Web interface → Web API: sends HTTP
README.md - Web API → Agent orchestration: handles chat
client/Simulated_backend/main.py - Terminal agent → Agent orchestration: uses agent
README.md - Agent orchestration → MCP server: calls tools
client/Simulated_backend/main.py - MCP server → Tool guidance: configures with
server.py - MCP server → Screen control: registers tools
server.py - MCP server → Data analysis: registers tool
server.py - MCP server → Web research: registers tool
server.py - MCP server → Script preview and undo: registers tools
server.py - Screen control → File discovery: finds paths
tools/screen_control.py - Script preview and undo → File discovery: finds folders
tools/script_writer.py - Script preview and undo → Script sandbox: runs scripts
- Web research → Data analysis: analyzes findings
tools/research_topic.py - Data analysis → PDF rendering: renders report
tools/analyze_data.py - Web research → PDF rendering: writes report
tools/research_topic.py - Productivity automations → Data analysis: uses analysis
extra_productivity/automations.py