# shivangbhatt10/private-api-mcp architecture

> Architecture diagram of the GitHub repository shivangbhatt10/private-api-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shivangbhatt10/private-api-mcp
- Repository: https://github.com/shivangbhatt10/private-api-mcp

## Overview

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: [`src/private_api_mcp/server.py`](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/server.py) (MCP server), [`src/private_api_mcp/capture/importers.py`](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/importers.py) (Traffic importers), [`src/private_api_mcp/codegen/cli_codegen.py`](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/codegen/cli_codegen.py) (Client generation CLI), [`src/private_api_mcp/capture/cdp_listener.py`](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/cdp_listener.py) (CDP listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Traffic capture"]
  node_listener["CDP listener<br/>[cdp_listener.py]"]
  node_filters["Noise filters<br/>[filters.py]"]
  node_importers["Traffic importers<br/>[importers.py]"]
  node_session["Capture session<br/>[session.py]"]
end

subgraph group_analysis["Endpoint analysis"]
  node_models["Exchange models<br/>[models.py]"]
  node_cluster["Endpoint clustering<br/>[cluster.py]"]
  node_schema["Schema inference<br/>[schema_inferrer.py]"]
end

subgraph group_replay["Replay and auth"]
  node_auth["Credential analysis<br/>[auth_analyzer.py]"]
  node_minimizer["Replay minimizer<br/>[minimizer.py]"]
end

subgraph group_delivery["Agent and client output"]
  node_server["MCP server<br/>[server.py]"]
  node_cli["Command-line interface<br/>[cli.py]"]
  node_codegen_cli["Client generation CLI<br/>[cli_codegen.py]"]
  node_codegen["Python client generator<br/>[python_httpx.py]"]
end

node_agent(("Agent or developer"))
node_chrome["Chrome browser"]
node_traffic_files["cURL / HAR traffic"]
node_api["Observed web API"]
node_client_files["Typed client and env files"]

node_agent -->|"requests tools"| node_server
node_agent -->|"runs commands"| node_cli
node_chrome -->|"supplies traffic"| node_listener
node_listener -->|"filters requests"| node_filters
node_listener -->|"stores exchanges"| node_session
node_traffic_files -->|"provides traffic"| node_importers
node_importers -->|"filters HAR entries"| node_filters
node_importers -->|"normalizes paths"| node_cluster
node_importers -->|"builds exchanges"| node_models
node_session -->|"stores exchanges"| node_models
node_server -->|"starts capture"| node_listener
node_server -->|"reads exchanges"| node_session
node_server -->|"clusters exchanges"| node_cluster
node_cluster -->|"infers schemas"| node_schema
node_server -->|"imports traffic"| node_importers
node_server -->|"inspects credentials"| node_auth
node_server -->|"replays endpoint"| node_minimizer
node_minimizer -->|"classifies headers"| node_auth
node_api -->|"receives replay"| node_minimizer
node_cli -->|"dispatches generation"| node_codegen_cli
node_codegen_cli -->|"loads exchanges"| node_session
node_codegen_cli -->|"generates client"| node_codegen
node_codegen_cli -->|"extracts credentials"| node_auth
node_codegen -->|"writes client code"| node_client_files
node_auth -->|"exports credentials"| node_client_files
node_server -->|"exports client"| node_codegen

click node_server "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/server.py"
click node_cli "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/cli.py"
click node_listener "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/cdp_listener.py"
click node_filters "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/filters.py"
click node_importers "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/importers.py"
click node_session "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/session.py"
click node_models "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/models.py"
click node_cluster "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/cluster.py"
click node_schema "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/schema_inferrer.py"
click node_auth "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/auth_analyzer.py"
click node_minimizer "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/minimizer.py"
click node_codegen_cli "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/codegen/cli_codegen.py"
click node_codegen "https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/codegen/python_httpx.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_listener,node_filters,node_importers,node_session,node_chrome,node_client_files toneBlue
class node_models,node_cluster,node_schema toneAmber
class node_auth,node_minimizer,node_api toneMint
class node_server,node_cli,node_codegen_cli,node_codegen toneRose
class node_agent,node_traffic_files toneIndigo
```

## Components

### Traffic capture

- [CDP listener](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/cdp_listener.py): `src/private_api_mcp/capture/cdp_listener.py`
- [Noise filters](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/filters.py): `src/private_api_mcp/capture/filters.py`
- [Traffic importers](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/importers.py): `src/private_api_mcp/capture/importers.py`
- [Capture session](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/capture/session.py): `src/private_api_mcp/capture/session.py`

### Endpoint analysis

- [Exchange models](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/models.py): `src/private_api_mcp/models.py`
- [Endpoint clustering](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/cluster.py): `src/private_api_mcp/engine/cluster.py`
- [Schema inference](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/schema_inferrer.py): `src/private_api_mcp/engine/schema_inferrer.py`

### Replay and auth

- [Credential analysis](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/auth_analyzer.py): `src/private_api_mcp/engine/auth_analyzer.py`
- [Replay minimizer](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/engine/minimizer.py): `src/private_api_mcp/engine/minimizer.py`

### Agent and client output

- [MCP server](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/server.py): `src/private_api_mcp/server.py`
- [Command-line interface](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/cli.py): `src/private_api_mcp/cli.py`
- [Client generation CLI](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/codegen/cli_codegen.py): `src/private_api_mcp/codegen/cli_codegen.py`
- [Python client generator](https://github.com/shivangbhatt10/private-api-mcp/blob/main/src/private_api_mcp/codegen/python_httpx.py): `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

- Agent or developer → MCP server: requests tools (evidence: `README.md`)
- Agent or developer → Command-line interface: runs commands (evidence: `README.md`)
- Chrome browser → CDP listener: supplies traffic (evidence: `README.md`)
- CDP listener → Noise filters: filters requests (evidence: `src/private_api_mcp/capture/cdp_listener.py`)
- CDP listener → Capture session: stores exchanges (evidence: `src/private_api_mcp/capture/cdp_listener.py`)
- cURL / HAR traffic → Traffic importers: provides traffic (evidence: `README.md`)
- Traffic importers → Noise filters: filters HAR entries (evidence: `src/private_api_mcp/capture/importers.py`)
- Traffic importers → Endpoint clustering: normalizes paths (evidence: `src/private_api_mcp/capture/importers.py`)
- Traffic importers → Exchange models: builds exchanges (evidence: `src/private_api_mcp/capture/importers.py`)
- Capture session → Exchange models: stores exchanges (evidence: `src/private_api_mcp/capture/session.py`)
- MCP server → CDP listener: starts capture (evidence: `README.md`)
- MCP server → Capture session: reads exchanges (evidence: `src/private_api_mcp/server.py`)
- MCP server → Endpoint clustering: clusters exchanges (evidence: `src/private_api_mcp/server.py`)
- Endpoint clustering → Schema inference: infers schemas (evidence: `src/private_api_mcp/engine/cluster.py`)
- MCP server → Traffic importers: imports traffic (evidence: `README.md`)
- MCP server → Credential analysis: inspects credentials (evidence: `README.md`)
- MCP server → Replay minimizer: replays endpoint (evidence: `src/private_api_mcp/server.py`)
- Replay minimizer → Credential analysis: classifies headers (evidence: `src/private_api_mcp/engine/minimizer.py`)
- Observed web API → Replay minimizer: receives replay (evidence: `README.md`)
- Command-line interface → Client generation CLI: dispatches generation (evidence: `src/private_api_mcp/cli.py`)
- Client generation CLI → Capture session: loads exchanges (evidence: `src/private_api_mcp/codegen/cli_codegen.py`)
- Client generation CLI → Python client generator: generates client (evidence: `src/private_api_mcp/codegen/cli_codegen.py`)
- Client generation CLI → Credential analysis: extracts credentials (evidence: `src/private_api_mcp/codegen/cli_codegen.py`)
- Python client generator → Typed client and env files: writes client code (evidence: `README.md`)
- Credential analysis → Typed client and env files: exports credentials (evidence: `README.md`)
- MCP server → Python client generator: exports client (evidence: `README.md`)
