How mizcausevic-dev/mcp-session-recorder works
MCP Session Recorder is a FastAPI application for reviewing recorded MCP runs, their approval and evidence posture, and replay priority. Operators enter through HTML pages or JSON endpoints; handlers call the session service, which derives dashboard, inventory, approval, replay, sharing, auth-posture, sample, and recollection results from the bundled session data. The HTML surfaces include replay controls. The render source excerpt is partial, so the graph avoids asserting details about how replay data is supplied to those controls.
Main entry points: main.py FastAPI routes · sample_session_data.json Sample sessions · render.py HTML pages · session_service.py Dashboard summary
Components 14
Application entry
- FastAPI routes
app/main.py - Session APIs
app/main.py
Operator surfaces
- HTML pages
app/render.py
Session analysis
- Dashboard summary
app/services/session_service.py - Session inventory
app/services/session_service.py - Approval board
app/services/session_service.py - Replay priorities
app/services/session_service.py - Sharing matrix
app/services/session_service.py - Auth posture
app/services/session_service.py - Session recollection
app/services/session_service.py - Sample payload
app/services/session_service.py
Session records
- Sample sessions
app/data/sample_session_data.json
Other components
- Operator
- API client
Connections 24
- Operator → FastAPI routes: requests pages
- API client → Session APIs: requests data
- FastAPI routes → HTML pages: renders pages
- FastAPI routes → Dashboard summary: calls summary
- FastAPI routes → Session inventory: calls inventory
- FastAPI routes → Approval board: calls approvals
- FastAPI routes → Replay priorities: calls replay
- FastAPI routes → Sharing matrix: calls sharing
- FastAPI routes → Auth posture: calls posture
- FastAPI routes → Session recollection: calls recollection
- FastAPI routes → Sample payload: calls sample
- HTML pages → Dashboard summary: reads summary
- HTML pages → Session inventory: reads sessions
- HTML pages → Approval board: reads approvals
- HTML pages → Replay priorities: reads replay data
- HTML pages → Sharing matrix: reads shares
- Dashboard summary → Sample sessions: reads records
- Session inventory → Sample sessions: reads records
- Approval board → Sample sessions: reads records
- Replay priorities → Sample sessions: reads records
- Sharing matrix → Sample sessions: reads records
- Auth posture → Sample sessions: reads records
- Session recollection → Sample sessions: ranks records
- Sample payload → Sample sessions: reads records