How adityaa2404/pict-live-mcp works
PICT Live MCP Server exposes live interview discovery and research tools to MCP clients; its main path runs from stdio tool calls through crawling, extraction, validation, indexing, and search or analysis. It also provides a separate Placed-27 site-crawling capability. The README documents the major workflows, while excerpts show selected call relationships; unsampled tool and graph internals are represented at their exact directory paths, and uncertain links are omitted.
Main entry points: mcp_tools.py MCP tools · live_client.py PICT live client · placed27_graph.py Placed-27 crawl graph · crawl4ai_runtime.py HTTP and browser runtime
Components 22
MCP runtime
- MCP server
main.py - MCP tools
app/tools/mcp_tools.py - Runtime settings
app/config/settings.py
PICT live data
- PICT live client
app/services/live_client.py - PICT crawl graph
app/agent/pict_live_graph.py - Crawl frontier
app/crawl_frontier.py - Source index
app/source_index.py - TTL cache
app/cache/manager.py
Crawling and parsing
- Page navigation
app/browser/navigation.py - HTTP and browser runtime
app/browser/crawl4ai_runtime.py - Interview extractor
app/parser/extractor.py - Validated records
app/models/schemas.py
Research tools
- Interview search
app/services/search.py - Company comparison
app/services/compare.py - Grounded summaries
app/services/summarizer.py
Placed-27 crawling
- Placed-27 client
app/services/placed27_client.py - Placed-27 crawl graph
app/agent/placed27_graph.py - Site page extractor
app/parser/site_extractor.py - Local LLM enrichment
app/agent/local_llm.py
Other components
- MCP client
- pict.live
- Placed-27 site
Connections 25
- MCP client → MCP server: sends MCP
README.md - MCP server → MCP tools: loads tools
main.py - MCP tools → PICT live client: calls
app/tools/mcp_tools.py - MCP tools → Interview search: searches
app/tools/mcp_tools.py - MCP tools → Company comparison: compares
app/tools/mcp_tools.py - MCP tools → Grounded summaries: summarizes
app/tools/mcp_tools.py - MCP tools → Placed-27 client: calls
app/tools/mcp_tools.py - PICT live client → PICT crawl graph: runs crawl
app/services/live_client.py - PICT live client → TTL cache: reads and writes
app/services/live_client.py - PICT live client → Source index: indexes records
app/services/live_client.py - PICT live client → Page navigation: fetches pages
README.md - PICT crawl graph → Crawl frontier: queues URLs
app/agent/pict_live_graph.py - PICT crawl graph → Interview extractor: parses pages
app/agent/pict_live_graph.py - Page navigation → HTTP and browser runtime: fetches through
app/browser/navigation.py - HTTP and browser runtime → pict.live: requests pages
README.md - Interview extractor → Validated records: validates records
app/parser/extractor.py - Interview search → Validated records: returns records
app/services/search.py - Company comparison → Validated records: uses records
app/services/compare.py - Grounded summaries → Validated records: uses records
app/services/summarizer.py - MCP tools → Source index: searches index
app/tools/mcp_tools.py - Placed-27 client → Placed-27 crawl graph: runs crawl
app/services/placed27_client.py - Placed-27 crawl graph → HTTP and browser runtime: fetches pages
app/agent/placed27_graph.py - Placed-27 crawl graph → Site page extractor: extracts pages
app/agent/placed27_graph.py - Placed-27 crawl graph → Local LLM enrichment: enriches pages
app/agent/placed27_graph.py - HTTP and browser runtime → Placed-27 site: requests pages