How wonderwhy-er/desktopcommandermcp works
Desktop Commander is an MCP server for AI clients to inspect and edit files, search code, manage configuration, and run or control local processes. The principal workflow is a client tool request routed by the server to a handler, which invokes a domain manager or file operation and returns a result. The README also documents document-format support, a file-preview UI, and remote access. Some handler and remote wiring is unsampled, so uncertain links are omitted or marked unverified.
Main entry points: index.ts Tool Handlers · app.ts File Preview UI · server.ts MCP Server · filesystem.ts Filesystem Tools
Components 25
MCP Runtime
- MCP Server
src/server.ts - Tool Handlers
src/handlers/index.ts - Tool Schemas
src/tools/schemas.ts
Files and Search
- Filesystem Handlers
src/handlers/filesystem-handlers.ts - Filesystem Tools
src/tools/filesystem.ts - File Readers
src/utils/files/base.ts - Search Handlers
src/handlers/search-handlers.ts - Search Manager
src/search-manager.ts - Edit Handlers
src/handlers/edit-search-handlers.ts - Edit Tools
src/tools/edit.ts
Processes and Config
- Terminal Manager
src/terminal-manager.ts - Command Manager
src/command-manager.ts - Configuration
src/config-manager.ts
Remote Access
- Remote Launcher
src/npm-scripts/remote.ts - Device Auth
src/remote-device/device-authenticator.ts - Remote Channel
src/remote-device/remote-channel.ts - MQTT Enrollment
src/remote-device/mqtt/mqtt-enrollment.ts - MQTT Transport
src/remote-device/mqtt/mqtt-transport.ts
Client UIs
- File Preview UI
src/ui/file-preview/src/app.ts - Preview Renderers
src/ui/file-preview/src/file-type-handlers.ts - Markdown Editor
src/ui/file-preview/src/markdown/controller.ts - Directory View
src/ui/file-preview/src/directory-controller.ts - Preview Payload
src/ui/file-preview/src/payload-utils.ts - Config Editor UI
src/ui/config-editor/src/app.ts
Other components
- AI Client
Connections 24
- AI Client → MCP Server: sends tool requests
README.md - MCP Server → Tool Handlers: dispatches tools
src/server.ts - Tool Handlers → Tool Schemas: uses schemas
- Tool Handlers → Filesystem Handlers: routes filesystem
- Filesystem Handlers → Filesystem Tools: calls tools
src/handlers/filesystem-handlers.ts - Filesystem Tools → File Readers: uses readers
src/tools/filesystem.ts - Tool Handlers → Search Handlers: routes search
- Search Handlers → Search Manager: calls search
src/handlers/search-handlers.ts - Search Manager → Filesystem Tools: validates paths
src/search-manager.ts - Tool Handlers → Edit Handlers: routes edits
- Edit Handlers → Edit Tools: calls edits
src/handlers/edit-search-handlers.ts - Command Manager → Configuration: reads settings
src/command-manager.ts - Terminal Manager → Configuration: reads settings
src/terminal-manager.ts - AI Client → Remote Launcher: starts remote access
README.md - Remote Launcher → Device Auth: starts device auth
src/npm-scripts/remote.ts - Device Auth → Remote Channel: uses channel
src/remote-device/device-authenticator.ts - MQTT Enrollment → MQTT Transport: uses transport
src/remote-device/mqtt/mqtt-enrollment.ts - MCP Server → File Preview UI: serves UI resources
src/server.ts - File Preview UI → Preview Renderers: selects renderers
src/ui/file-preview/src/app.ts - Preview Renderers → Directory View: renders directories
src/ui/file-preview/src/file-type-handlers.ts - File Preview UI → Markdown Editor: uses editor controller
src/ui/file-preview/src/app.ts - File Preview UI → Preview Payload: uses payload helpers
src/ui/file-preview/src/app.ts - File Preview UI → AI Client: renders previews
README.md - Config Editor UI → AI Client: presents settings
README.md