How theayzek01/mev works
MEV is an offline decision engine and intent-oriented file finder, exposed through a browser cockpit, MCP tools, and a decision HTTP API. The main flow accepts a user query or state, routes language where needed, then returns a typed decision or ranked file results. Search includes exact matching, semantic ranking and optional disk caching; decisions use distilled task data. The README documents these capabilities, but excerpts do not show all search internals or MCP dispatch, so uncertain links are omitted.
Main entry points: mcp_server.py File finder · mev.py Typed decisions · dashboard.py Browser cockpit · index_cache.py Index cache
Components 15
User interfaces
- Browser cockpit
dashboard.py - MCP tools
mcp_server.py - Decision HTTP API
mev.py
Decision engine
- Typed decisions
mev.py - Language routing
mev.py - Distilled tasks
distilled_tasks.json
File search
- File finder
mcp_server.py - Semantic ranking
mcp_server.py - Exact matching
mcp_server.py
Search state
- Index cache
index_cache.py
Other components
- User
- Repository files
- `.mevidx` cache
- Ranked files
- Typed result
Connections 20
- User → Browser cockpit: uses
README.md - Browser cockpit → Typed decisions: submits state
dashboard.py - Browser cockpit → File finder: submits search
dashboard.py - Browser cockpit → Language routing: submits text
dashboard.py - User → MCP tools: invokes tools
README.md - MCP tools → Typed decisions: delegates to
mcp_server.py - MCP tools → Language routing: delegates to
mcp_server.py - MCP tools → File finder: runs search
mcp_server.py - User → Decision HTTP API: posts decision
README.md - Decision HTTP API → Typed decisions: calls
mev.py - Typed decisions → Language routing: routes text
mev.py - Typed decisions → Distilled tasks: loads task data
mev.py - Typed decisions → Typed result: returns
mev.py - File finder → Language routing: routes query
mcp_server.py - File finder → Repository files: scans and reads
mcp_server.py - File finder → Exact matching: matches literals
mcp_server.py - File finder → Semantic ranking: ranks candidates
mcp_server.py - File finder → Index cache: loads and updates
mcp_server.py - Index cache → `.mevidx` cache: reads and writes
index_cache.py - File finder → Ranked files: returns results
README.md