Desktop Commander MCP

¿Qué es Desktop Commander MCP?

Desktop Commander MCP es un servidor del Protocolo de Contexto del Modelo (MCP) que permite una interacción avanzada a nivel de sistema entre modelos de lenguaje de IA (como Claude Desktop) y su máquina local. Va mucho más allá de los editores de IA típicos al envolver herramientas esenciales para desarrolladores: comandos de terminal, gestión de archivos, edición de código y automatización, detrás de una interfaz segura que trabaja directamente a través de Claude Desktop, sin requerir créditos por token de API. Está diseñado para convertir a Claude en un asistente de desarrollo versátil capaz de explorar completamente la base de código, realizar cambios precisos, scripting de automatización y gestión de flujos de trabajo en todo su sistema operativo, no solo dentro de un IDE.

Cómo configurar Desktop Commander MCP

Instalar Claude Desktop: Descargue e instale Claude Desktop.
Instalación rápida mediante npx: Ejecute npx @wonderwhy-er/desktop-commander@latest setup en su terminal.
Otras opciones de instalación:
- Utilice la CLI de Smithery con npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
- Utilice el script de bash para macOS: curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
- Edite su claude_desktop_config.json, agregando la configuración del servidor bajo mcpServers
- O clone/construya localmente con git clone ..., npm run setup.
Reinicie Claude Desktop después de la configuración para habilitar el nuevo servidor MCP.
Configure los ajustes:
- Utilice get_config({}) y set_config_value({ key, value }) dentro del chat de Claude para ajustar opciones como comandos bloqueados, directorios permitidos o shell predeterminado.
- Siempre verifique los cambios de configuración con get_config({}).
- Por seguridad, mantenga un chat de configuración dedicado y especifique límites exactos de acceso a directorios.

Los ajustes se persisten en config.json dentro del directorio de trabajo del servidor. Puede desactivar la telemetría directamente pidiendo a Claude que "desactive la telemetría" en el chat.

Cómo usar Desktop Commander MCP

Inicie Claude Desktop y abra un nuevo chat.
Interactúe usando lenguaje natural: Pida a Claude que realice operaciones como leer, buscar, editar archivos, ejecutar comandos de terminal o gestionar procesos; Claude invocará las herramientas MCP correspondientes.

Llamadas manuales a herramientas: Puede usar los nombres de funciones de herramientas MCP directamente, por ejemplo:

execute_command({ "command": "ls -la", "shell": "/bin/zsh" })
read_file({ "path": "README.md" })
edit_block({ "changes": "...editar formato de bloque..." })

Manejo de tareas de larga duración:
- Para procesos que continúan en segundo plano, use list_sessions para monitorear, read_output para obtener la salida del comando y force_terminate para detenerlos.
Búsqueda y edición de texto/código:
- Utilice la sintaxis de bloque de edición para reemplazos precisos.
- Utilice herramientas como search_code, search_files y edit_block para realizar y coordinar cambios sofisticados en la base de código.
Cambiar de shells:
- Seleccione su shell preferido a través del argumento shell en las herramientas de comando, por ejemplo, bash, zsh o powershell.

La interfaz le permite automatizar tareas sin problemas, realizar scripting de sistema, gestionar archivos y procesos, y editar código, todo a través de conversaciones con Claude.

Características clave

Ejecución de comandos de terminal: Ejecute comandos con salida en vivo, tiempos de espera y shells personalizados.
Gestión de procesos en segundo plano: Liste, monitoree y mate procesos o sesiones de terminal en ejecución.
Gestión de configuraciones: Obtenga/establézcase configuraciones del servidor, incluidas restricciones de comandos y acceso a directorios sin necesidad de reiniciar.
Operaciones en el sistema de archivos: Lea, escriba, mueva, busque y obtenga información sobre archivos/directorios; admite operaciones por lotes y búsquedas por patrones.
Búsqueda/edición de archivo: Búsqueda de texto/código difusa y de múltiples ocurrencias y reemplazos de patrones utilizando formatos de bloque de edición seguros.
Edición avanzada de código: Cambios textuales quirúrgicos, soporte para múltiples archivos, coincidencia de patrones e integración con ripgrep para exploración profunda de la base de código.
Manejo de imágenes y URL: read_file puede prever y analizar tanto archivos locales como recursos web remotos, soportando tanto texto como imágenes.
Controles de seguridad: Defina directorios permitidos, bloquee comandos riesgosos y revise la telemetría (soportada opción de exclusión).
Multiplataforma: Funciona completamente en macOS, Windows y Linux, con correcciones automáticas específicas para cada entorno.

Casos de uso

Explorar, buscar y entender grandes o complejas bases de código en minutos
Refactorización o parches precisos y quirúrgicos de código en múltiples archivos/proyectos
Generar documentación o diagramas extrayendo y procesando código/texto
Automatizar tareas repetitivas o inter-proyectos para desarrolladores desde una sola interfaz de chat
Realizar scripting de sistema, configuración de entornos y gestión de procesos a través de IA
Depurar rápidamente, ejecutar pruebas o terminar procesos, compilaciones y ejecuciones de servidor
Trabajar en múltiples entornos de SO sin costo por token de API

Preguntas frecuentes

1. ¿Qué es Desktop Commander MCP? Es un servidor MCP que potencia a Claude Desktop para interactuar completamente con su sistema de archivos y SO, permitiendo tareas como exploración de la base de código, edición de código detallada, automatización y control de terminal/procesos a través de lenguaje natural.

2. ¿Cómo se diferencia esto de herramientas como Cursor o Windsurf? Desktop Commander MCP ofrece un amplio control a nivel de SO más allá de cualquier IDE, soporta flujos de trabajo en múltiples proyectos y directorios, proporciona acceso completo a archivos (no en trozos), y aprovecha el plan Pro de Claude Desktop sin costos adicionales por token de API.

3. ¿Desktop Commander requiere créditos de API o pago extra? No—una vez que tiene Claude Desktop Pro, todas las operaciones ocurren localmente sin cargos adicionales por uso o por token.

4. ¿Cómo actualizo Desktop Commander? Si se instaló a través de npx o Smithery, Desktop Commander se actualiza automáticamente al reiniciar Claude Desktop. Para instalaciones manuales, solo vuelva a ejecutar el comando de configuración.

5. ¿Se recopilan datos de telemetría? La telemetría es mínima y no personal por defecto. Puede optar por no participar en cualquier momento pidiendo a Claude: "desactivar telemetría".

Nombre del Protocolo	Descripción
get_config	Recupera la configuración actual del servidor (comandos bloqueados, shell predeterminado, directorios permitidos) como JSON.
set_config_value	Actualiza un valor de configuración específico como directorios permitidos, comandos bloqueados o shell predeterminado.
execute_command	Ejecuta un comando de terminal con opciones de tiempo de espera y selección de shell, transmite la salida del comando.
read_output	Obtiene nueva salida de un comando/sesión de terminal que se está ejecutando.
force_terminate	Termina de manera forzada una sesión o comando de terminal en ejecución por ID de sesión.
list_sessions	Lista todas las sesiones de comando de terminal en ejecución o en segundo plano.
list_processes	Muestra todos los procesos del SO en ejecución con información detallada (PID, comando, etc.).
kill_process	Termina un proceso por su ID de proceso (PID).
read_file	Lee y devuelve el contenido de un archivo local o URL; admite tanto datos de texto como de imagen.
read_multiple_files	Lee el contenido de múltiples archivos a la vez (operación por lotes).
write_file	Reescribe un archivo entero con nuevo contenido (adecuado para cambios grandes).
create_directory	Crea un nuevo directorio o asegura que exista.
list_directory	Proporciona un listado detallado de archivos y subdirectorios en una ruta dada.
move_file	Mueve o renombra archivos o directorios.
search_files	Encuentra archivos por nombre con coincidencias de subcadenas sin distinción de mayúsculas y búsqueda difusa.
search_code	Busca dentro de los contenidos de los archivos patrones de texto/código (impulsado por ripgrep) recursivamente.
get_file_info	Recupera metadatos detallados sobre un archivo o directorio (por ejemplo, tamaño, marcas de tiempo, tipo).
edit_block	Realiza reemplazos de texto/código precisos y basados en patrones utilizando un formato de bloque de edición para cambios quirúrgicos.