# ewoudboutje/network-experience-2627-n8n architecture

> Architecture diagram of the GitHub repository ewoudboutje/network-experience-2627-n8n, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ewoudboutje/network-experience-2627-n8n
- Repository: https://github.com/ewoudboutje/network-experience-2627-n8n

## Overview

This repository documents an n8n automation environment, but the supplied tree contains only the Minecraft MCP server and the Proxmox MCP package—not the central compose file or workflow exports. The represented workflow is n8n calling an MCP server to reach Minecraft or Proxmox; Proxmox’s server configures tools, which perform infrastructure operations. The graph preserves those products and the sampled security, OAuth, job, and VM/storage layers. Some integration links are documented rather than visible in source; unsampled workflow behavior is not inferred.

Main entry points: [`Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py) (Proxmox MCP server), [`Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py`](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py) (Built-in tool plugins), [`Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py`](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py) (VM operations), [`Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py`](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py) (Storage selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp_services["MCP Services"]
  node_minecraft_mcp["Minecraft MCP<br/>[server.py]"]
  node_proxmox_server["Proxmox MCP server<br/>[server.py]"]
end

subgraph group_proxmox_runtime["Proxmox Runtime"]
  node_proxmox_config["Configuration<br/>[models.py]"]
  node_proxmox_connection["Proxmox connectivity<br/>[proxmox.py]"]
end

subgraph group_security_auth["Security and Auth"]
  node_oauth_provider["OAuth provider"]
  node_oauth_store[("OAuth state store<br/>[mcp_oauth_store.py]")]
  node_resource_security["Resource validation<br/>[resources.py]"]
end

subgraph group_proxmox_tools["Proxmox Tools"]
  node_tool_plugins["Built-in tool plugins"]
  node_vm_tools["VM operations<br/>[vm.py]"]
  node_container_tools["Container operations<br/>[containers.py]"]
  node_storage_tools["Storage operations<br/>[storage.py]"]
  node_storage_selection["Storage selection"]
  node_job_tools["Job operations<br/>[jobs.py]"]
end

node_n8n(("n8n workflows"))
node_proxmox(("Proxmox API"))
node_minecraft(("Minecraft environment"))

node_n8n -->|"calls MCP"| node_minecraft_mcp
node_n8n -->|"calls MCP"| node_proxmox_server
node_proxmox_server -->|"loads config"| node_proxmox_config
node_proxmox_server -->|"initializes connection"| node_proxmox_connection
node_proxmox_server -->|"registers routes"| node_oauth_provider
node_oauth_provider -->|"uses state store"| node_oauth_store
node_proxmox_server -->|"registers plugins"| node_tool_plugins
node_tool_plugins -->|"dispatches VM calls"| node_vm_tools
node_tool_plugins -->|"dispatches container calls"| node_container_tools
node_vm_tools -->|"calls API"| node_proxmox
node_storage_tools -->|"reads storage"| node_proxmox
node_vm_tools -->|"selects storage"| node_storage_selection
node_storage_selection -->|"validates identifiers"| node_resource_security
node_storage_selection -->|"reads inventory"| node_proxmox
node_job_tools -->|"validates resources"| node_resource_security
node_minecraft_mcp -.->|"communicates with"| node_minecraft
node_proxmox_connection -.->|"connects to API"| node_proxmox

click node_minecraft_mcp "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Minecraft_dashboard/minecraft-mcp/server.py"
click node_proxmox_server "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py"
click node_proxmox_config "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/config/models.py"
click node_proxmox_connection "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/core/proxmox.py"
click node_oauth_provider "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_provider.py"
click node_oauth_store "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_store.py"
click node_tool_plugins "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py"
click node_vm_tools "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py"
click node_container_tools "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/containers.py"
click node_storage_tools "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage.py"
click node_storage_selection "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py"
click node_job_tools "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/jobs.py"
click node_resource_security "https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/security/resources.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_minecraft_mcp,node_proxmox_server toneBlue
class node_proxmox_config,node_proxmox_connection toneAmber
class node_oauth_provider,node_oauth_store,node_resource_security,node_proxmox toneMint
class node_tool_plugins,node_vm_tools,node_container_tools,node_storage_tools,node_storage_selection,node_job_tools toneRose
class node_n8n,node_minecraft toneIndigo
```

## Components

### MCP Services

- [Minecraft MCP](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Minecraft_dashboard/minecraft-mcp/server.py): `Minecraft_dashboard/minecraft-mcp/server.py`
- [Proxmox MCP server](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`

### Proxmox Runtime

- [Configuration](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/config/models.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/config/models.py`
- [Proxmox connectivity](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/core/proxmox.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/core/proxmox.py`

### Security and Auth

- [OAuth provider](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_provider.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_provider.py`
- [OAuth state store](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_store.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_store.py`
- [Resource validation](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/security/resources.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/security/resources.py`

### Proxmox Tools

- [Built-in tool plugins](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py`
- [VM operations](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py`
- [Container operations](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/containers.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/containers.py`
- [Storage operations](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage.py`
- [Storage selection](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py`
- [Job operations](https://github.com/ewoudboutje/network-experience-2627-n8n/blob/main/Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/jobs.py): `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/jobs.py`

### Other components

- **n8n workflows**
- **Proxmox API**
- **Minecraft environment**

## Connections

- n8n workflows → Minecraft MCP: calls MCP (evidence: `README.md`)
- n8n workflows → Proxmox MCP server: calls MCP (evidence: `README.md`)
- Proxmox MCP server → Configuration: loads config (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`)
- Proxmox MCP server → Proxmox connectivity: initializes connection (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`)
- Proxmox MCP server → OAuth provider: registers routes (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`)
- OAuth provider → OAuth state store: uses state store (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/mcp_oauth_provider.py`)
- Proxmox MCP server → Built-in tool plugins: registers plugins (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/server.py`)
- Built-in tool plugins → VM operations: dispatches VM calls (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py`)
- Built-in tool plugins → Container operations: dispatches container calls (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/builtin_tool_plugins.py`)
- VM operations → Proxmox API: calls API (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py`)
- Storage operations → Proxmox API: reads storage (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage.py`)
- VM operations → Storage selection: selects storage (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/vm.py`)
- Storage selection → Resource validation: validates identifiers (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py`)
- Storage selection → Proxmox API: reads inventory (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/tools/storage_selection.py`)
- Job operations → Resource validation: validates resources (evidence: `Proxmox_agent_dashboard/proxmox-agent/source/src/proxmox_mcp/services/jobs.py`)
- Minecraft MCP → Minecraft environment: communicates with (evidence: `README.md`)
- Proxmox connectivity → Proxmox API: connects to API (evidence: `README.md`)
