How eepstein201/jev-mcp works
Jev MCP is a local-model MCP server for typed evaluation and task routing. An MCP client submits a tool request to the server, which dispatches evaluation through a hybrid provider: Kev handles confident, smaller decisions, while uncertain or large-context requests escalate to the local smart-model daemon. The server also exposes repository scanning and semantic chunking, prompt linting, context compaction, and router management. The README documents additional ML workflows, but their implementation is not established by the sampled source, so they are not expanded into inferred components.
Main entry points: server.py MCP Tool Server · daemon_provider.py Smart Daemon Provider · routing_provider.py Hybrid Router · kev_provider.py Kev Provider
Components 15
MCP Entry
- MCP Tool Server
src/jev_mcp/server.py - Decision Linter
src/jev_mcp/linter.py - Linter CLI
src/jev_mcp/cli_linter.py
Evaluation Engines
- Typed Questions
src/jev_mcp/provider.py - Hybrid Router
src/jev_mcp/routing_provider.py - Kev Provider
src/jev_mcp/kev_provider.py - Smart Daemon Provider
src/jev_mcp/daemon_provider.py - Provider Contract
src/jev_mcp/provider.py
Repository Tools
- Repository Scanner
src/jev_mcp/scanner.py - Semantic Chunker
src/jev_mcp/chunker.py
Policy and Configuration
- Payload and Path Safety
src/jev_mcp/security.py - Router Configuration
src/jev_mcp/router_config.py
Other components
- MCP Client
- Kev Local Service
- MLX Local Service
Connections 18
- MCP Client → MCP Tool Server: calls tools
README.md - MCP Tool Server → Hybrid Router: evaluates
src/jev_mcp/server.py - Hybrid Router → Kev Provider: evaluates first
src/jev_mcp/routing_provider.py - Hybrid Router → Smart Daemon Provider: escalates uncertain
src/jev_mcp/routing_provider.py - Kev Provider → Kev Local Service: posts evaluations
src/jev_mcp/kev_provider.py - Smart Daemon Provider → MLX Local Service: posts evaluations
src/jev_mcp/daemon_provider.py - Kev Provider → Provider Contract: uses contract
src/jev_mcp/kev_provider.py - Smart Daemon Provider → Provider Contract: uses transport
src/jev_mcp/daemon_provider.py - Hybrid Router → Provider Contract: implements contract
src/jev_mcp/routing_provider.py - MCP Tool Server → Decision Linter: checks prompts
src/jev_mcp/server.py - Linter CLI → Decision Linter: runs lint
src/jev_mcp/cli_linter.py - MCP Tool Server → Repository Scanner: scans repositories
src/jev_mcp/server.py - MCP Tool Server → Semantic Chunker: extracts code chunks
src/jev_mcp/server.py - MCP Tool Server → Payload and Path Safety: sanitizes and guards paths
src/jev_mcp/server.py - MCP Tool Server → Router Configuration: manages router settings
src/jev_mcp/server.py - Smart Daemon Provider → Router Configuration: loads temperature
src/jev_mcp/daemon_provider.py - Smart Daemon Provider → Payload and Path Safety: sanitizes payloads
src/jev_mcp/daemon_provider.py - Kev Provider → Payload and Path Safety: sanitizes payloads
src/jev_mcp/kev_provider.py