# zueai/mcp-manager architecture

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

- Interactive diagram: https://gitdiagram.com/zueai/mcp-manager
- Repository: https://github.com/zueai/mcp-manager

## Overview

##### Main Components
- Electron Main Process: This is found in the “electron” directory (main.ts and preload.ts). It acts as the bridge between the native OS and the renderer process.
- Renderer Process / Frontend: Located under “src” where you have your React code (App.tsx, various components, assets, and utility functions). This handles UI rendering and user interaction.
- Server Configuration Components: Under “src/components/server-configs”, these components are dedicated to configuring various MCP server integrations (Apple Notes, AWS, PostgreSQL, etc.).
- External Services / MCP Servers: Represent each MCP server integration (e.g., Apple Notes, Slack, GitHub, etc.) as external nodes that the application can communicate with.
- Build and Configuration Tools: While not “runtime” components, include build scripts (Vite, Electron Builder) and configuration files (tsconfig.json, tailwind.config.ts, etc.) as part of the overall architecture documentation.

##### Relationships and Interactions
- The Electron main process initializes and manages the window(s) in which the React-based renderer runs.
- The renderer (React) uses the preloaded functionality provided by preload.ts to communicate with the underlying OS and native features.
- UI components in the “src” directory interact with user inputs and then either invoke IPC (inter-process communication) to the Electron main process or directly call utility functions.
- Server configuration modules and utility files in “src” indicate how the UI interacts with external MCP servers. Represent these configurations as integration points that send terminal commands or API calls to MCP servers.

##### Architectural Patterns/Design Principles
- Separation of Concerns: The design cleanly separates between desktop-specific concerns (Electron main process) and UI logic (React components).
- Modular Design: Each MCP server has its own configuration component, enabling extensibility.
- Client-Server Interaction within a Desktop App: Even though it’s a desktop application, the application simulates a client-server pattern where the main process serves as a backend layer for the renderer.
- Code Quality and Dependency Management: With ESLint, TypeScript, and Biome checks, emphasize that the project maintains strong code quality and static type-checking.

##### Relevant Technologies/Frameworks to Highlight
- Electron (for the desktop runtime environment)
- React (for the UI)
- Vite (for the build process)
- Bun (as the package manager)
- TypeScript for static typing and code quality tools (ESLint, Biome)

## Diagram (Mermaid)

```mermaid
flowchart TD
    A["MCP Manager for Claude Desktop"]:::external

    subgraph "Desktop Environment (Electron)"
        E1["Electron Main Process"]:::electron
        E2["Electron Preload Script"]:::electron
    end

    subgraph "Renderer Process (React UI)"
        R1["React Renderer / Frontend"]:::frontend
        subgraph "MCP Server Configurations"
            SC1["env-config.tsx"]:::config
            SC2["filesystem-config.tsx"]:::config
            SC3["obsidian-config.tsx"]:::config
            SC4["postgres-config.tsx"]:::config
            SC5["sentry-config.tsx"]:::config
            SC6["sqlite-config.tsx"]:::config
        end
    end

    subgraph "Build and Configuration Tools"
        BT1["vite.config.ts"]:::build
        BT2["tsconfig.json"]:::build
        BT3["tailwind.config.ts"]:::build
        BT4["postcss.config.js"]:::build
        BT5["eslint.config.js"]:::build
        BT6["biome.json"]:::build
    end

    %% Connections between main components
    A -->|"runs"| E1
    A -->|"renders"| R1
    BT6 -->|"builds"| A

    %% IPC bridge chain between Renderer and Electron
    R1 -->|"IPC_calls"| E2
    E2 -->|"bridges_to"| E1

    %% Connections from Server Configurations to external MCP servers
    FC1["Filesystem Server"]:::external
    OB1["Obsidian Server"]:::external
    PG1["PostgreSQL Server"]:::external
    SE1["Sentry Server"]:::external
    SQ1["SQLite Server"]:::external

    SC2 -->|"configures"| FC1
    SC3 -->|"configures"| OB1
    SC4 -->|"configures"| PG1
    SC5 -->|"configures"| SE1
    SC6 -->|"configures"| SQ1

    %% Styles
    classDef electron fill:#cce5ff,stroke:#004085,stroke-width:2px;
    classDef frontend fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef build fill:#fff3cd,stroke:#856404,stroke-width:2px;
    classDef config fill:#f8d7da,stroke:#721c24,stroke-width:2px;
    classDef external fill:#e2e3e5,stroke:#6c757d,stroke-width:2px;

    %% Click Events
    click E1 "https://github.com/zueai/mcp-manager/blob/main/electron/main.ts"
    click E2 "https://github.com/zueai/mcp-manager/blob/main/electron/preload.ts"
    click R1 "https://github.com/zueai/mcp-manager/blob/main/src/App.tsx"
    click SC1 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click SC2 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click SC3 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click SC4 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click SC5 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click SC6 "https://github.com/zueai/mcp-manager/tree/main/src/components/server-configs"
    click BT1 "https://github.com/zueai/mcp-manager/blob/main/vite.config.ts"
    click BT2 "https://github.com/zueai/mcp-manager/blob/main/tsconfig.json"
    click BT3 "https://github.com/zueai/mcp-manager/blob/main/tailwind.config.ts"
    click BT4 "https://github.com/zueai/mcp-manager/blob/main/postcss.config.js"
    click BT5 "https://github.com/zueai/mcp-manager/blob/main/eslint.config.js"
    click BT6 "https://github.com/zueai/mcp-manager/blob/main/biome.json"
```
