# tencentedgeone/edgeone-pages-mcp architecture

> Architecture diagram of the GitHub repository tencentedgeone/edgeone-pages-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tencentedgeone/edgeone-pages-mcp
- Repository: https://github.com/tencentedgeone/edgeone-pages-mcp

## Overview

##### Project type and purpose
- From the file tree (index.ts, package.json, tools/*.ts, examples/, assets/) and absence of a detailed README, we infer this is a TypeScript-based, npm-published CLI library whose job is to package and deploy static assets (HTML/CSS/JS) either as a folder or as a zip, and as a standalone HTML deploy.

##### File structure
- Top-level files:
– index.ts: the library’s main entry point (exports CLI commands or core functions)
– package.json / tsconfig.json: Node/TypeScript configuration and dependency manifest
- Directories:
– tools/: two scripts (deploy_folder_or_zip.ts and deploy_html.ts) that implement the two deployment modes
– examples/: a sample “public” folder and a zipped version showing how consumers would call the tool
– assets/: supporting files (architecture.drawio)
- Lack of a backend service—this is a single-package CLI that likely invokes external endpoints or file-system operations.

##### (empty) README for insights
- There is no README content, so all architectural insights must be drawn from code layout and naming conventions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Layer
    User["User/CI Terminal"]:::external

    %% CLI Interface Layer
    subgraph "CLI Interface Layer"
        CLI["index.ts"]:::cli
    end

    %% Core Library Layer
    subgraph "Core Library Layer"
        Core["index.ts (exports packageFolder(), packageZip(), buildHtml())"]:::core
    end

    %% Tooling Layer
    subgraph "Tooling Layer"
        FolderZip["deploy_folder_or_zip.ts"]:::tool
        HTMLDeploy["deploy_html.ts"]:::tool
    end

    %% Examples
    subgraph "Example Consumer"
        PublicExample["examples/public/"]:::example
        ZipExample["examples/public.zip"]:::example
    end

    %% Config & Assets
    subgraph "Configuration & Assets"
        PackageJSON["package.json"]:::config
        TSConfig["tsconfig.json"]:::config
        DrawIO["assets/architecture.drawio"]:::config
    end

    %% External Systems
    subgraph "External Systems"
        FS["File System"]:::external
        Cloud["External Upload Service"]:::external
    end

    %% Connections
    User -->|"invokes CLI"| CLI
    CLI -->|"calls core API"| Core
    CLI -->|"runs script"| FolderZip
    CLI -->|"runs script"| HTMLDeploy

    FolderZip -->|"uses functions"| Core
    HTMLDeploy -->|"uses functions"| Core

    Core -->|"read/write"| FS
    FolderZip -->|"read/write"| FS
    HTMLDeploy -->|"read/write"| FS

    FolderZip -->|"upload"| Cloud
    HTMLDeploy -->|"upload"| Cloud

    PublicExample -.->|"sample input"| CLI
    ZipExample -.->|"sample input"| CLI

    PackageJSON -.->|"configures build"| CLI
    TSConfig -.->|"configures build"| CLI
    DrawIO -.->|"diagram source"| config

    %% Click Events
    click CLI "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/index.ts"
    click Core "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/index.ts"
    click FolderZip "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/tools/deploy_folder_or_zip.ts"
    click HTMLDeploy "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/tools/deploy_html.ts"
    click PublicExample "https://github.com/tencentedgeone/edgeone-pages-mcp/tree/main/examples/public/"
    click ZipExample "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/examples/public.zip"
    click PackageJSON "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/package.json"
    click TSConfig "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/tsconfig.json"
    click DrawIO "https://github.com/tencentedgeone/edgeone-pages-mcp/blob/main/assets/architecture.drawio"

    %% Styles
    classDef cli fill:#B3CDE0,stroke:#333,stroke-width:1px;
    classDef core fill:#6497B1,stroke:#333,stroke-width:1px;
    classDef tool fill:#005B96,stroke:#fff,stroke-width:1px;
    classDef example fill:#C7E9B4,stroke:#333,stroke-width:1px;
    classDef config fill:#D9D9D9,stroke:#333,stroke-width:1px;
    classDef external fill:#CCCCCC,stroke:#333,stroke-width:1px;
```
