# 1999azzar/hela-mcp-ecosystem architecture
> Architecture diagram of the GitHub repository 1999azzar/hela-mcp-ecosystem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.
- Interactive diagram: https://gitdiagram.com/1999azzar/hela-mcp-ecosystem
- Repository: https://github.com/1999azzar/hela-mcp-ecosystem
## Overview
HeLa MCP Ecosystem combines profile-based setup and client configuration with an HTTP gateway for routing MCP traffic to specialized servers. The main user workflow is selecting a profile and client, generating or installing that configuration, then having an AI client send requests to the selected MCP services (directly or through the gateway). README capabilities are represented from documentation; detailed setup internals and most backend implementations were not sampled, so their wiring is shown only where documented or supported by gateway source.
Main entry points: [`gateway/server.mjs`](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/server.mjs) (HTTP Gateway), [`setup.sh`](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/setup.sh) (Setup & Update), [`scripts/generate-config.mjs`](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/scripts/generate-config.mjs) (Client Config Generator), [`config/profiles.json`](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/config/profiles.json) (Profile Catalog)
## Diagram (Mermaid)
```mermaid
flowchart TD
subgraph group_profiles["Profiles & Setup"]
node_setup["Setup & Update
[setup.sh]"]
node_profiles_data["Profile Catalog
[profiles.json]"]
node_inventory["Server Inventory
[inventory.json]"]
node_snapshots["Pinned Snapshots"]
node_configgen["Client Config Generator"]
node_client_examples["Client Examples"]
end
subgraph group_gateway["Gateway"]
node_gateway_server["HTTP Gateway
[server.mjs]"]
node_router["Capability Router
[router.mjs]"]
node_cache["List Cache
[cache.mjs]"]
end
subgraph group_services["MCP Services"]
node_mitosis["Mitosis Orchestrator"]
node_genome[("Genome Memory")]
node_membrane["Membrane Filesystem"]
node_nucleus["Nucleus Execution"]
node_ribosome["Ribosome PTY"]
node_enzyme["Enzyme Research"]
node_cytosol["Cytosol Browser"]
node_phenotype["Phenotype Design"]
node_receptor["Receptor Mobile"]
node_plastid["Plastid 3D Modeling"]
end
node_user(("Operator"))
node_client(("AI Client"))
node_user -->|"selects profile"| node_setup
node_setup -->|"uses profiles"| node_profiles_data
node_setup -->|"uses inventory"| node_inventory
node_setup -->|"pins snapshot"| node_snapshots
node_user -->|"requests config"| node_configgen
node_configgen -->|"reads profiles"| node_profiles_data
node_configgen -->|"resolves servers"| node_inventory
node_configgen -->|"emits config"| node_client
node_client -.->|"sends MCP requests"| node_gateway_server
node_gateway_server -->|"resolves backend"| node_router
node_gateway_server -->|"checks lists"| node_cache
node_gateway_server -.->|"forwards requests"| node_mitosis
node_gateway_server -.->|"forwards requests"| node_genome
node_gateway_server -.->|"forwards requests"| node_membrane
node_gateway_server -.->|"forwards requests"| node_nucleus
node_gateway_server -.->|"forwards requests"| node_ribosome
node_gateway_server -.->|"forwards requests"| node_enzyme
node_gateway_server -.->|"forwards requests"| node_phenotype
node_client -.->|"uses by profile"| node_cytosol
node_client -.->|"uses by profile"| node_receptor
node_client -.->|"uses by profile"| node_plastid
click node_setup "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/setup.sh"
click node_profiles_data "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/config/profiles.json"
click node_inventory "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/config/inventory.json"
click node_snapshots "https://github.com/1999azzar/hela-mcp-ecosystem/tree/master/config/snapshots"
click node_configgen "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/scripts/generate-config.mjs"
click node_client_examples "https://github.com/1999azzar/hela-mcp-ecosystem/tree/master/config"
click node_gateway_server "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/server.mjs"
click node_router "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/router.mjs"
click node_cache "https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/cache.mjs"
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_setup,node_profiles_data,node_inventory,node_snapshots,node_configgen,node_client_examples,node_client toneBlue
class node_gateway_server,node_router,node_cache toneAmber
class node_mitosis,node_genome,node_membrane,node_nucleus,node_ribosome,node_enzyme,node_cytosol,node_phenotype,node_receptor,node_plastid toneMint
class node_user toneIndigo
```
## Components
### Profiles & Setup
- [Setup & Update](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/setup.sh): `setup.sh`
- [Profile Catalog](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/config/profiles.json): `config/profiles.json`
- [Server Inventory](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/config/inventory.json): `config/inventory.json`
- [Pinned Snapshots](https://github.com/1999azzar/hela-mcp-ecosystem/tree/master/config/snapshots): `config/snapshots`
- [Client Config Generator](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/scripts/generate-config.mjs): `scripts/generate-config.mjs`
- [Client Examples](https://github.com/1999azzar/hela-mcp-ecosystem/tree/master/config): `config`
### Gateway
- [HTTP Gateway](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/server.mjs): `gateway/server.mjs`
- [Capability Router](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/router.mjs): `gateway/router.mjs`
- [List Cache](https://github.com/1999azzar/hela-mcp-ecosystem/blob/master/gateway/cache.mjs): `gateway/cache.mjs`
### MCP Services
- **Mitosis Orchestrator**
- **Genome Memory**
- **Membrane Filesystem**
- **Nucleus Execution**
- **Ribosome PTY**
- **Enzyme Research**
- **Cytosol Browser**
- **Phenotype Design**
- **Receptor Mobile**
- **Plastid 3D Modeling**
### Other components
- **Operator**
- **AI Client**
## Connections
- Operator → Setup & Update: selects profile
- Setup & Update → Profile Catalog: uses profiles
- Setup & Update → Server Inventory: uses inventory
- Setup & Update → Pinned Snapshots: pins snapshot
- Operator → Client Config Generator: requests config
- Client Config Generator → Profile Catalog: reads profiles
- Client Config Generator → Server Inventory: resolves servers
- Client Config Generator → AI Client: emits config
- AI Client → HTTP Gateway: sends MCP requests
- HTTP Gateway → Capability Router: resolves backend
- HTTP Gateway → List Cache: checks lists
- HTTP Gateway → Mitosis Orchestrator: forwards requests
- HTTP Gateway → Genome Memory: forwards requests
- HTTP Gateway → Membrane Filesystem: forwards requests
- HTTP Gateway → Nucleus Execution: forwards requests
- HTTP Gateway → Ribosome PTY: forwards requests
- HTTP Gateway → Enzyme Research: forwards requests
- HTTP Gateway → Phenotype Design: forwards requests
- AI Client → Cytosol Browser: uses by profile
- AI Client → Receptor Mobile: uses by profile
- AI Client → Plastid 3D Modeling: uses by profile