Add MCP server

- Expose a bunch of file exploring features so that we can access them from the command palette
- Add 8 missing commands
- Test it thoroughly
- Add docs

Author: vdavid

apps/desktop/src-tauri/Cargo.lock

@@ -44,6 +44,10 @@ env_logger = "0.11.8"
 log = "0.4"
 # HTTP client for license server validation
 reqwest = { version = "0.12", features = ["json", "rustls-tls"], default-features = false }
+# MCP server
+axum = "0.8"
+tokio = { version = "1", features = ["rt-multi-thread", "net", "time", "sync", "macros"] }
+tower-http = { version = "0.6", features = ["cors"] }
 [target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
 tauri-plugin-window-state = "2"
 
@@ -52,8 +56,6 @@ core-foundation = "0.10.1"
 core-services = "1.0.0"
 icns = "0.3.1"
 plist = "1.8.0"
-tokio = { version = "1.49.0", features = ["rt", "time"] }
-
 urlencoding = "2.1.3"
 objc2 = { version = "0.6", features = ["std"] }
 objc2-foundation = { version = "0.3", features = [

apps/desktop/src-tauri/Cargo.toml

@@ -40,6 +40,7 @@ pub mod icons;
 pub mod licensing;
 #[cfg(target_os = "macos")]
 mod macos_icons;
+mod mcp;
 mod menu;
 #[cfg(target_os = "macos")]
 mod network;
@@ -51,7 +52,8 @@ mod volumes;
 
 use menu::{
     ABOUT_ID, COMMAND_PALETTE_ID, GO_BACK_ID, GO_FORWARD_ID, GO_PARENT_ID, MenuState, SHOW_HIDDEN_FILES_ID,
-    SWITCH_PANE_ID, VIEW_MODE_BRIEF_ID, VIEW_MODE_FULL_ID, ViewMode,
+    SORT_ASCENDING_ID, SORT_BY_CREATED_ID, SORT_BY_EXTENSION_ID, SORT_BY_MODIFIED_ID, SORT_BY_NAME_ID, SORT_BY_SIZE_ID,
+    SORT_DESCENDING_ID, SWITCH_PANE_ID, VIEW_MODE_BRIEF_ID, VIEW_MODE_FULL_ID, ViewMode,
 };
 use tauri::{Emitter, Manager};
 
@@ -136,6 +138,13 @@ pub fn run() {
                 let _ = window.set_title(&title);
             }
 
+            // Initialize pane state store for MCP context tools
+            app.manage(mcp::PaneStateStore::new());
+
+            // Start MCP server for AI agent integration
+            let mcp_config = mcp::McpConfig::from_env();
+            mcp::start_mcp_server(app.handle().clone(), mcp_config);
+
             Ok(())
         })
         .on_menu_event(|app, event| {
@@ -191,6 +200,29 @@ pub fn run() {
             } else if id == SWITCH_PANE_ID {
                 // Emit event to switch pane
                 let _ = app.emit("switch-pane", ());
+            } else if id == SORT_BY_NAME_ID
+                || id == SORT_BY_EXTENSION_ID
+                || id == SORT_BY_SIZE_ID
+                || id == SORT_BY_MODIFIED_ID
+                || id == SORT_BY_CREATED_ID
+            {
+                // Handle sort by column
+                let column = match id {
+                    SORT_BY_NAME_ID => "name",
+                    SORT_BY_EXTENSION_ID => "extension",
+                    SORT_BY_SIZE_ID => "size",
+                    SORT_BY_MODIFIED_ID => "modified",
+                    SORT_BY_CREATED_ID => "created",
+                    _ => return,
+                };
+                let _ = app.emit("menu-sort", serde_json::json!({ "action": "sortBy", "value": column }));
+            } else if id == SORT_ASCENDING_ID || id == SORT_DESCENDING_ID {
+                // Handle sort order
+                let order = if id == SORT_ASCENDING_ID { "asc" } else { "desc" };
+                let _ = app.emit(
+                    "menu-sort",
+                    serde_json::json!({ "action": "sortOrder", "value": order }),
+                );
             } else {
                 // Handle file actions
                 commands::ui::execute_menu_action(app, id);
@@ -221,6 +253,9 @@ pub fn run() {
             commands::ui::copy_to_clipboard,
             commands::ui::quick_look,
             commands::ui::get_info,
+            mcp::pane_state::update_left_pane_state,
+            mcp::pane_state::update_right_pane_state,
+            mcp::pane_state::update_focused_pane,
             #[cfg(target_os = "macos")]
             commands::sync_status::get_sync_status,
             #[cfg(target_os = "macos")]

apps/desktop/src-tauri/src/lib.rs

@@ -0,0 +1,62 @@
+//! MCP server configuration.
+
+use std::env;
+
+/// Configuration for the MCP server, read from environment variables.
+#[derive(Debug, Clone)]
+pub struct McpConfig {
+    /// Whether the MCP server is enabled
+    pub enabled: bool,
+    /// Port to listen on
+    pub port: u16,
+}
+
+impl McpConfig {
+    /// Load configuration from environment variables.
+    pub fn from_env() -> Self {
+        let enabled = env::var("CMDR_MCP_ENABLED")
+            .map(|v| v == "true" || v == "1")
+            .unwrap_or(cfg!(debug_assertions)); // Default: enabled in debug builds
+
+        let port = env::var("CMDR_MCP_PORT")
+            .ok()
+            .and_then(|v| v.parse().ok())
+            .unwrap_or(9224);
+
+        Self { enabled, port }
+    }
+}
+
+impl Default for McpConfig {
+    fn default() -> Self {
+        Self::from_env()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_default_values() {
+        let config = McpConfig {
+            enabled: true,
+            port: 9224,
+        };
+
+        assert_eq!(config.port, 9224);
+        assert!(config.enabled);
+    }
+
+    #[test]
+    fn test_from_env_returns_config() {
+        let config = McpConfig::from_env();
+        assert!(config.port > 0);
+    }
+
+    #[test]
+    fn test_default_impl() {
+        let config = McpConfig::default();
+        assert!(config.port > 0);
+    }
+}