# rodriguedev13/obambu-cpanel-mcp architecture

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

- Interactive diagram: https://gitdiagram.com/rodriguedev13/obambu-cpanel-mcp
- Repository: https://github.com/rodriguedev13/obambu-cpanel-mcp

## Overview

This is an MCP server that turns assistant tool requests into cPanel UAPI operations. An MCP client connects over stdio; registered tools handle account summaries, domains, DNS, email, file listing, MySQL, and a generic UAPI escape hatch. Those handlers call a shared client, which builds authenticated HTTPS requests and returns UAPI data. The README documents the tool capabilities; the sampled source shows their dispatch and shared transport, but not the cPanel service internals.

Main entry points: [`src/index.ts`](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts) (Tool server), [`src/cpanelClient.ts`](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/cpanelClient.ts) (UAPI client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP interface"]
  node_server["Tool server<br/>[index.ts]"]
end

subgraph group_account["Account and domains"]
  node_account_tools["Account summary<br/>[index.ts]"]
  node_domain_tools["Domain listing<br/>[index.ts]"]
end

subgraph group_provision["Resource management"]
  node_dns_tools["DNS tools<br/>[index.ts]"]
  node_email_tools["Email tools<br/>[index.ts]"]
  node_mysql_tools["MySQL tools<br/>[index.ts]"]
end

subgraph group_access["File and API access"]
  node_file_tools["File listing<br/>[index.ts]"]
  node_generic_tool["Generic UAPI<br/>[index.ts]"]
end

subgraph group_client["cPanel access"]
  node_cpanel_client["UAPI client<br/>[cpanelClient.ts]"]
end

node_assistant(("MCP client"))
node_cpanel["cPanel UAPI"]

node_assistant -->|"connects over stdio"| node_server
node_server -->|"registers tools"| node_account_tools
node_server -->|"registers tools"| node_domain_tools
node_server -->|"registers tools"| node_dns_tools
node_server -->|"registers tools"| node_email_tools
node_server -->|"registers tools"| node_mysql_tools
node_server -->|"registers tools"| node_file_tools
node_server -->|"registers tool"| node_generic_tool
node_account_tools -->|"calls UAPI"| node_cpanel_client
node_domain_tools -->|"calls UAPI"| node_cpanel_client
node_dns_tools -->|"calls UAPI"| node_cpanel_client
node_email_tools -->|"calls UAPI"| node_cpanel_client
node_mysql_tools -->|"calls UAPI"| node_cpanel_client
node_file_tools -->|"calls UAPI"| node_cpanel_client
node_generic_tool -->|"calls UAPI"| node_cpanel_client
node_cpanel_client -->|"sends HTTPS requests"| node_cpanel

click node_server "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_account_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_domain_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_dns_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_email_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_mysql_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_file_tools "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_generic_tool "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts"
click node_cpanel_client "https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/cpanelClient.ts"

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_server,node_assistant toneBlue
class node_account_tools,node_domain_tools toneAmber
class node_dns_tools,node_email_tools,node_mysql_tools,node_cpanel toneMint
class node_file_tools,node_generic_tool toneRose
class node_cpanel_client toneIndigo
```

## Components

### MCP interface

- [Tool server](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`

### Account and domains

- [Account summary](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`
- [Domain listing](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`

### Resource management

- [DNS tools](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`
- [Email tools](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`
- [MySQL tools](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`

### File and API access

- [File listing](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`
- [Generic UAPI](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/index.ts): `src/index.ts`

### cPanel access

- [UAPI client](https://github.com/rodriguedev13/obambu-cpanel-mcp/blob/master/src/cpanelClient.ts): `src/cpanelClient.ts`

### Other components

- **MCP client**
- **cPanel UAPI**

## Connections

- MCP client → Tool server: connects over stdio (evidence: `src/index.ts`)
- Tool server → Account summary: registers tools (evidence: `src/index.ts`)
- Tool server → Domain listing: registers tools (evidence: `src/index.ts`)
- Tool server → DNS tools: registers tools (evidence: `src/index.ts`)
- Tool server → Email tools: registers tools (evidence: `src/index.ts`)
- Tool server → MySQL tools: registers tools (evidence: `src/index.ts`)
- Tool server → File listing: registers tools (evidence: `src/index.ts`)
- Tool server → Generic UAPI: registers tool (evidence: `src/index.ts`)
- Account summary → UAPI client: calls UAPI (evidence: `src/index.ts`)
- Domain listing → UAPI client: calls UAPI (evidence: `src/index.ts`)
- DNS tools → UAPI client: calls UAPI (evidence: `src/index.ts`)
- Email tools → UAPI client: calls UAPI (evidence: `src/index.ts`)
- MySQL tools → UAPI client: calls UAPI (evidence: `src/index.ts`)
- File listing → UAPI client: calls UAPI (evidence: `src/index.ts`)
- Generic UAPI → UAPI client: calls UAPI (evidence: `src/index.ts`)
- UAPI client → cPanel UAPI: sends HTTPS requests (evidence: `src/cpanelClient.ts`)
