How shivangbhatt10/private-api-mcp works
private-api-mcp observes or imports web traffic, organizes it into reusable endpoint signatures, analyzes authentication, optionally verifies requests by replay, and generates typed Python clients. Its MCP server and CLI expose these capabilities to agents and developers. The README documents the end-to-end workflow; source excerpts and the SOURCE INDEX support the internal relationships shown. Some runtime wiring is unsampled, so those connections are omitted rather than inferred.
Main entry points: server.py MCP server · importers.py Traffic importers · cli_codegen.py Client generation CLI · cdp_listener.py CDP listener
Components 18
Traffic capture
- CDP listener
src/private_api_mcp/capture/cdp_listener.py - Noise filters
src/private_api_mcp/capture/filters.py - Traffic importers
src/private_api_mcp/capture/importers.py - Capture session
src/private_api_mcp/capture/session.py
Endpoint analysis
- Exchange models
src/private_api_mcp/models.py - Endpoint clustering
src/private_api_mcp/engine/cluster.py - Schema inference
src/private_api_mcp/engine/schema_inferrer.py
Replay and auth
- Credential analysis
src/private_api_mcp/engine/auth_analyzer.py - Replay minimizer
src/private_api_mcp/engine/minimizer.py
Agent and client output
- MCP server
src/private_api_mcp/server.py - Command-line interface
src/private_api_mcp/cli.py - Client generation CLI
src/private_api_mcp/codegen/cli_codegen.py - Python client generator
src/private_api_mcp/codegen/python_httpx.py
Other components
- Agent or developer
- Chrome browser
- cURL / HAR traffic
- Observed web API
- Typed client and env files
Connections 26
- Agent or developer → MCP server: requests tools
README.md - Agent or developer → Command-line interface: runs commands
README.md - Chrome browser → CDP listener: supplies traffic
README.md - CDP listener → Noise filters: filters requests
src/private_api_mcp/capture/cdp_listener.py - CDP listener → Capture session: stores exchanges
src/private_api_mcp/capture/cdp_listener.py - cURL / HAR traffic → Traffic importers: provides traffic
README.md - Traffic importers → Noise filters: filters HAR entries
src/private_api_mcp/capture/importers.py - Traffic importers → Endpoint clustering: normalizes paths
src/private_api_mcp/capture/importers.py - Traffic importers → Exchange models: builds exchanges
src/private_api_mcp/capture/importers.py - Capture session → Exchange models: stores exchanges
src/private_api_mcp/capture/session.py - MCP server → CDP listener: starts capture
README.md - MCP server → Capture session: reads exchanges
src/private_api_mcp/server.py - MCP server → Endpoint clustering: clusters exchanges
src/private_api_mcp/server.py - Endpoint clustering → Schema inference: infers schemas
src/private_api_mcp/engine/cluster.py - MCP server → Traffic importers: imports traffic
README.md - MCP server → Credential analysis: inspects credentials
README.md - MCP server → Replay minimizer: replays endpoint
src/private_api_mcp/server.py - Replay minimizer → Credential analysis: classifies headers
src/private_api_mcp/engine/minimizer.py - Observed web API → Replay minimizer: receives replay
README.md - Command-line interface → Client generation CLI: dispatches generation
src/private_api_mcp/cli.py - Client generation CLI → Capture session: loads exchanges
src/private_api_mcp/codegen/cli_codegen.py - Client generation CLI → Python client generator: generates client
src/private_api_mcp/codegen/cli_codegen.py - Client generation CLI → Credential analysis: extracts credentials
src/private_api_mcp/codegen/cli_codegen.py - Python client generator → Typed client and env files: writes client code
README.md - Credential analysis → Typed client and env files: exports credentials
README.md - MCP server → Python client generator: exports client
README.md