# domitorai/mcp-code-editor architecture

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

- Interactive diagram: https://gitdiagram.com/domitorai/mcp-code-editor
- Repository: https://github.com/domitorai/mcp-code-editor

## Overview

mcp-code-editor is a Windows desktop application that exposes a local project to an AI agent through an MCP endpoint. The documented workflow is to choose a project and access mode, start the application, connect an MCP client, then inspect or change project files and review changes with Git. The tree contains no application source excerpts, so implementation paths and internal call ownership cannot be verified; edges below reflect only relationships the README documents.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop control"]
  node_desktop_app["Desktop application"]
  node_project_select["Project selection"]
  node_mode["Access mode"]
end

subgraph group_access["Connection and access"]
  node_mcp["MCP server"]
  node_oauth["OAuth 2.1"]
  node_tunnel["Cloudflare Tunnel"]
end

subgraph group_project["Project tools"]
  node_project_files[("Project files")]
  node_file_tools["File and search tools"]
  node_image_tools["Image viewing"]
  node_command_tools["Build and command tools"]
  node_approval["Command approval"]
  node_audit[("Change audit log")]
end

subgraph group_intelligence["Code intelligence"]
  node_intelligence_tools["Code navigation"]
end

node_user(("Project owner"))
node_client(("AI agent / MCP client"))
node_cloudflare["Cloudflare service"]
node_language_services["Language services"]
node_git["Git review"]

node_user -->|"configures and starts"| node_desktop_app
node_desktop_app -->|"selects project"| node_project_select
node_desktop_app -->|"sets access mode"| node_mode
node_desktop_app -->|"exposes MCP endpoint"| node_mcp
node_client -->|"connects to endpoint"| node_mcp
node_client -->|"authenticates with"| node_oauth
node_desktop_app -->|"starts tunnel"| node_tunnel
node_tunnel -->|"publishes endpoint"| node_cloudflare
node_mcp -->|"offers tools"| node_file_tools
node_mcp -->|"offers tools"| node_image_tools
node_mcp -->|"offers tools"| node_command_tools
node_mcp -->|"offers tools"| node_intelligence_tools
node_file_tools -->|"reads and edits"| node_project_files
node_image_tools -->|"reads images"| node_project_files
node_command_tools -->|"requests approval"| node_approval
node_approval -->|"presents command"| node_user
node_command_tools -->|"builds and tests"| node_project_files
node_file_tools -->|"records changes"| node_audit
node_intelligence_tools -.->|"uses when available"| node_language_services
node_user -->|"reviews changes"| node_git
node_project_files -->|"change review"| node_git

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_desktop_app,node_project_select,node_mode,node_client,node_git toneBlue
class node_mcp,node_oauth,node_tunnel toneAmber
class node_project_files,node_file_tools,node_image_tools,node_command_tools,node_approval,node_audit toneMint
class node_intelligence_tools toneRose
class node_user,node_cloudflare,node_language_services toneIndigo
```

## Components

### Desktop control

- **Desktop application**
- **Project selection**
- **Access mode**

### Connection and access

- **MCP server**
- **OAuth 2.1**
- **Cloudflare Tunnel**

### Project tools

- **Project files**
- **File and search tools**
- **Image viewing**
- **Build and command tools**
- **Command approval**
- **Change audit log**

### Code intelligence

- **Code navigation**

### Other components

- **Project owner**
- **AI agent / MCP client**
- **Cloudflare service**
- **Language services**
- **Git review**

## Connections

- Project owner → Desktop application: configures and starts (evidence: `README.md`)
- Desktop application → Project selection: selects project (evidence: `README.md`)
- Desktop application → Access mode: sets access mode (evidence: `README.md`)
- Desktop application → MCP server: exposes MCP endpoint (evidence: `README.md`)
- AI agent / MCP client → MCP server: connects to endpoint (evidence: `README.md`)
- AI agent / MCP client → OAuth 2.1: authenticates with (evidence: `README.md`)
- Desktop application → Cloudflare Tunnel: starts tunnel (evidence: `README.md`)
- Cloudflare Tunnel → Cloudflare service: publishes endpoint (evidence: `README.md`)
- MCP server → File and search tools: offers tools (evidence: `README.md`)
- MCP server → Image viewing: offers tools (evidence: `README.md`)
- MCP server → Build and command tools: offers tools (evidence: `README.md`)
- MCP server → Code navigation: offers tools (evidence: `README.md`)
- File and search tools → Project files: reads and edits (evidence: `README.md`)
- Image viewing → Project files: reads images (evidence: `README.md`)
- Build and command tools → Command approval: requests approval (evidence: `README.md`)
- Command approval → Project owner: presents command (evidence: `README.md`)
- Build and command tools → Project files: builds and tests (evidence: `README.md`)
- File and search tools → Change audit log: records changes (evidence: `README.md`)
- Code navigation → Language services: uses when available (evidence: `README.md`)
- Project owner → Git review: reviews changes (evidence: `README.md`)
- Project files → Git review: change review (evidence: `README.md`)
