Detalles del Proyecto Desktop Commander MCP

Resumen del Proyecto

Desktop Commander MCP es una herramienta de servidor basada en el Protocolo de Contexto de Modelo (MCP), diseñada específicamente para la aplicación Claude Desktop. A través del protocolo MCP, proporciona a Claude control de terminal, búsqueda en el sistema de archivos y capacidades de edición de archivos diferenciadas, transformando a Claude en un potente asistente de desarrollo.

Este proyecto extiende la funcionalidad del servidor de sistema de archivos MCP, permitiendo a los desarrolladores operar directamente en el sistema local a través de Claude, ejecutar comandos, administrar archivos y realizar edición de código, superando las capacidades de los editores de IA tradicionales.

Características Principales

🖥️ Operaciones de Terminal

• Ejecución de Comandos: Ejecuta comandos de terminal y admite la transmisión de salida en tiempo real.
• Control de Tiempo de Espera: Tiempo de espera configurable para comandos y soporte para ejecución en segundo plano.
• Gestión de Procesos: Lista y finaliza procesos en ejecución.
• Gestión de Sesiones: Soporte para la gestión de sesiones de comandos de larga duración.
• Soporte Multi-Shell: Soporte para diferentes entornos Shell como bash, zsh, powershell.

📁 Operaciones del Sistema de Archivos

• Lectura y Escritura de Archivos: Funcionalidad completa de lectura y escritura de archivos.
• Gestión de Directorios: Creación, listado, movimiento de archivos y directorios.
• Búsqueda de Archivos: Funcionalidad de búsqueda basada en nombres de archivos.
• Obtención de Metadatos: Obtención de información detallada de archivos y directorios.
• Soporte Multi-Archivo: Lectura simultánea de múltiples archivos.
• Lectura de Contenido de URL: Soporte para leer contenido de texto e imágenes desde URLs.

✏️ Capacidades de Edición de Código

• Reemplazo Preciso: Reemplazo de texto quirúrgico para modificaciones menores.
• Reescritura Completa: Reescritura completa de archivos para cambios significativos.
• Soporte Multi-Archivo: Edición simultánea de múltiples archivos.
• Reemplazo por Patrones: Reemplazo de texto basado en patrones.
• Búsqueda de Código: Utiliza vscode-ripgrep para la búsqueda recursiva de código o texto.

⚙️ Gestión de la Configuración del Servidor

• Obtención/Configuración de la Configuración: Obtención y configuración de valores de configuración.
• Actualización Masiva: Actualización de múltiples configuraciones a la vez.
• Configuración Dinámica: Realización de cambios de configuración sin necesidad de reiniciar el servidor.
• Control de Seguridad: Soporte para bloquear comandos específicos y restringir el acceso a directorios.

Métodos de Instalación

Método 1: Instalación Rápida con NPX (Recomendado)

npx @wonderwhy-er/desktop-commander@latest setup

Método 2: Instalación Automatizada en macOS

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Método 3: Instalación con Smithery

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

Método 4: Instalación Manual

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

Principales Herramientas Clasificadas

Herramientas de Gestión de Configuración

• get_config: Obtiene la configuración completa del servidor.
• set_config_value: Establece un valor de configuración específico.

Herramientas de Terminal

• execute_command: Ejecuta un comando de terminal.
• read_output: Lee la nueva salida de una sesión en ejecución.
• force_terminate: Fuerza la terminación de una sesión en ejecución.
• list_sessions: Lista todas las sesiones de terminal activas.
• list_processes: Lista todos los procesos en ejecución.
• kill_process: Termina un proceso por su PID.

Herramientas del Sistema de Archivos

• read_file: Lee un archivo local o contenido de una URL.
• read_multiple_files: Lee múltiples archivos simultáneamente.
• write_file: Reemplaza completamente el contenido de un archivo.
• create_directory: Crea un directorio.
• list_directory: Obtiene una lista detallada de un directorio.
• move_file: Mueve o renombra archivos y directorios.
• search_files: Busca archivos por nombre.
• search_code: Busca patrones de texto/código en el contenido de los archivos.
• get_file_info: Obtiene metadatos detallados de un archivo o directorio.

Herramientas de Edición de Texto

• edit_block: Aplica un reemplazo de texto quirúrgico.

Ventajas Técnicas

Comparación con Herramientas IDE Tradicionales

• Solución para Todo el Sistema: No se limita al entorno IDE, puede operar en todo el sistema operativo.
• Lectura Completa de Archivos: Claude puede leer archivos completos, en lugar de procesarlos por bloques.
• Soporte Multi-Proyecto: Puede manejar múltiples proyectos simultáneamente.
• Ejecución Única: Puede ejecutar cambios de una sola vez, reduciendo la necesidad de confirmaciones repetidas.

Rentabilidad

• Basado en la suscripción Pro estándar de Claude Desktop ($20/mes).
• Sin costos adicionales de llamadas a la API.
• Mecanismo de actualización automática, obtiene la última versión automáticamente al instalar con NPX o Smithery.

Casos de Uso

Escenarios de Desarrollo

• Exploración y comprensión de bases de código complejas.
• Generación de gráficos y documentación.
• Automatización de tareas entre sistemas.
• Trabajo simultáneo en múltiples proyectos.
• Modificación precisa de código.

Características de Seguridad

• Lista configurable de comandos bloqueados.
• Control de acceso a directorios permitido.
• Gestión y monitorización de procesos.
• Persistencia y validación de la configuración.