Skip to main content

Crate stygian_mcp

Crate stygian_mcp 

Source
Expand description

Unified MCP (Model Context Protocol) aggregator for Stygian.

Merges the tool surfaces of stygian-graph, stygian-browser, and stygian-proxy into a single MCP server. An LLM agent connecting to this server can scrape URLs, run pipeline DAGs, automate browsers, manage proxy pools, and combine all three capabilities — without needing to connect to three separate processes.

§Architecture


  LLM / IDE
     │  JSON-RPC 2.0 (stdin/stdout)
     ▼
┌─────────────────────────────┐
│        McpAggregator         │
│                             │
│  tools/list  ─── merge ─── ┤
│  tools/call  ─── route ─┐  │
└─────────────────────────┼──┘
     ┌──────────────────┬─┘
     ▼                  ▼
 GraphHandler      BrowserHandler  ProxyHandler
 (stygian-graph)   (stygian-       (stygian-
  scrape, rest,      browser)       proxy)
  graphql, rss,     acquire, nav,   add, acquire,
  sitemap,          eval, shot,     release, stats
  pipeline_*        verify, release

Tools are prefixed by crate: graph_scrape, browser_acquire, proxy_add. The aggregator itself adds two cross-crate tools:

ToolDescription
scrape_proxiedHTTP scrape routed through the proxy pool
browser_proxiedBrowser session with proxy from the pool

Modules§

aggregator
Aggregated MCP server that merges the graph, browser, and proxy tool surfaces.