Trabaje con código y texto, ejecute procesos y automatice tareas, yendo mucho más allá de otros editores de IA, sin costos de token API.
Todas tus herramientas de desarrollo de IA en un solo lugar. Desktop Commander reúne todas tus herramientas de desarrollo en un solo chat. Ejecuta comandos de terminal de larga duración en tu ordenador y gestiona procesos mediante el Protocolo de Contexto de Modelo (MCP). Desarrollado sobre el Servidor de Sistema de Archivos MCP para ofrecer funciones adicionales de búsqueda y reemplazo de archivos.
Primero, asegúrese de haber descargado e instalado la aplicación Claude Desktop y de tener instalado npm .
Simplemente ejecute esto en la terminal:
Para el modo de depuración (permite la conexión del inspector Node.js):
Reinicie Claude si está ejecutándose.
Para los usuarios de macOS, pueden usar nuestro instalador bash automatizado que verificará su versión de Node.js, la instalará si es necesario y configurará automáticamente Desktop Commander:
Este script maneja todas las dependencias y la configuración automáticamente para una experiencia de configuración perfecta.
Para instalar Desktop Commander para Claude Desktop automáticamente a través de Smithery :
Añade esta entrada a tu claude_desktop_config.json:
~/Library/Application\ Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonReinicie Claude si está ejecutándose.
Reinicie Claude si está ejecutándose.
El comando de configuración hará lo siguiente:
Al instalarlo mediante npx (Opción 1) o Smithery (Opción 3), Desktop Commander se actualizará automáticamente a la última versión al reiniciar Claude. No es necesario realizar ninguna actualización manual.
Para instalaciones manuales, puede actualizar ejecutando nuevamente el comando de configuración.
El servidor proporciona un conjunto completo de herramientas organizadas en varias categorías:
| Categoría | Herramienta | Descripción |
|---|---|---|
| Configuración | get_config | Obtenga la configuración completa del servidor como JSON (incluye blockingCommands, defaultShell, allowedDirectories, fileReadLineLimit, fileWriteLineLimit, telemetryEnabled) |
set_config_value | Establezca un valor de configuración específico por clave. Opciones disponibles: • blockedCommands : Matriz de comandos de shell que no se pueden ejecutar • defaultShell : Shell para comandos (p. ej., bash, zsh, powershell) • allowedDirectories : Matriz de rutas del sistema de archivos a las que el servidor puede acceder para operaciones con archivos (⚠️ los comandos de terminal aún pueden acceder a archivos fuera de estos directorios) • fileReadLineLimit : Máximo de líneas para leer simultáneamente (predeterminado: 1000) • fileWriteLineLimit : Máximo de líneas para escribir simultáneamente (predeterminado: 50) • telemetryEnabled : Habilitar/deshabilitar la telemetría (booleano) | |
| Terminal | execute_command | Ejecutar un comando de terminal con tiempo de espera configurable y selección de shell |
read_output | Leer nueva salida de una sesión de terminal en ejecución | |
force_terminate | Forzar la finalización de una sesión de terminal en ejecución | |
list_sessions | Listar todas las sesiones de terminal activas | |
list_processes | Enumere todos los procesos en ejecución con información detallada | |
kill_process | Terminar un proceso en ejecución por PID | |
| Sistema de archivos | read_file | Leer contenidos del sistema de archivos local o URL con paginación basada en líneas (admite parámetros de desplazamiento y longitud) |
read_multiple_files | Leer varios archivos simultáneamente | |
write_file | Escribe el contenido del archivo con opciones para reescribir o agregar (usa límites de línea configurables) | |
create_directory | Crea un nuevo directorio o asegúrate de que exista | |
list_directory | Obtenga una lista detallada de archivos y directorios | |
move_file | Mover o renombrar archivos y directorios | |
search_files | Busque archivos por nombre utilizando la coincidencia de subcadenas sin distinción entre mayúsculas y minúsculas | |
search_code | Busque patrones de texto/código dentro del contenido del archivo usando ripgrep | |
get_file_info | Recuperar metadatos detallados sobre un archivo o directorio | |
| Edición de texto | edit_block | Aplique reemplazos de texto específicos con indicaciones mejoradas para ediciones más pequeñas (incluye comentarios de diferenciación a nivel de carácter) |
Formato de bloque de búsqueda/reemplazo:
Ejemplo:
La herramienta edit_block incluye varias mejoras para una mayor confiabilidad:
{-removed-}{+added+}expected_replacementsCuando una búsqueda falla, verá información detallada sobre la coincidencia más cercana encontrada, incluyendo el porcentaje de similitud, el tiempo de ejecución y las diferencias de caracteres. Todos estos detalles se registran automáticamente para su posterior análisis mediante las herramientas de registro de búsquedas difusas.
read_file ahora puede obtener contenido tanto de archivos locales como de URLread_file con el parámetro isUrl: true para leer desde recursos webEl sistema de registro de búsqueda difusa incluye scripts npm convenientes para analizar registros fuera del entorno MCP:
Para obtener documentación detallada sobre estos scripts, consulte scripts/README.md .
Desktop Commander incluye un registro completo de operaciones de búsqueda aproximada en la herramienta edit_block . Si no se encuentra una coincidencia exacta, el sistema realiza una búsqueda aproximada y registra información detallada para su análisis.
Cada operación de búsqueda difusa registra:
Los registros se guardan automáticamente en:
~/.claude-server-commander-logs/fuzzy-search.log%USERPROFILE%\.claude-server-commander-logs\fuzzy-search.logLos registros de búsqueda difusa le ayudan a comprender:
Desktop Commander ahora incluye un registro completo de todas las llamadas a herramientas:
Los registros se guardan en:
~/.claude-server-commander/claude_tool_call.log%USERPROFILE%\.claude-server-commander\claude_tool_call.logEste registro de auditoría ayuda con la depuración, la supervisión de la seguridad y la comprensión de cómo Claude interactúa con su sistema.
Para comandos que pueden tardar un tiempo:
allowedDirectories ) si encuentra restricciones de acceso al sistema de archivos.allowedDirectories actualmente solo restringe las operaciones del sistema de archivos , no los comandos de terminal. Los comandos de terminal aún pueden acceder a archivos fuera de los directorios permitidos. El aislamiento completo de terminales está en desarrollo.Puede administrar la configuración del servidor utilizando las herramientas proporcionadas:
La configuración se guarda en config.json en el directorio de trabajo del servidor y persiste entre reinicios del servidor.
allowedDirectories vacíos : si lo establece en una matriz vacía ( [] ), otorga acceso a todo su sistema de archivos para operaciones con archivos./ , especifique los directorios exactos a los que desea acceder.get_config({}) para confirmar que los cambios se aplicaron correctamente.Puede especificar qué shell utilizar para la ejecución del comando:
Esto le permite utilizar características específicas del shell o mantener entornos consistentes entre comandos.
execute_command regresa después del tiempo de espera con la salida inicialread_output con PID para obtener una nueva salidaforce_terminate para detenerlo si es necesarioSi necesita depurar el servidor, puede instalarlo en modo de depuración:
Esto hará lo siguiente:
--inspect-brk=9229Para conectar un depurador:
chrome://inspect y busque la instancia Node.jsNotas de depuración importantes:
--inspect-brk )Solución de problemas:
Este proyecto amplía el servidor del sistema de archivos MCP para permitir:
Creado como parte de la exploración de Claude MCP: https://youtube.com/live/TlbjFDbl5Us
read_file ahora puede obtener contenido de las URLActualmente se están explorando las siguientes características:
Aquí se presentan los generosos colaboradores. ¡Gracias por hacer posible este proyecto!
Visita nuestro sitio web oficial en https://desktopcommander.app/ para obtener la información, documentación y actualizaciones más recientes.
Conozca más sobre este proyecto a través de estos recursos:
Claude, con MCP, reemplazó Cursor y Windsurf. ¿Cómo sucedió esto? - Un análisis detallado de cómo Claude, con las capacidades del Protocolo de Contexto de Modelo, está cambiando los flujos de trabajo de los desarrolladores.
Tutorial en vídeo de Claude Desktop Commander : vea cómo configurar y utilizar Commander de manera efectiva.
Únase a nuestro servidor Discord para obtener ayuda, compartir comentarios y conectarse con otros usuarios.
Si este proyecto te resulta útil, ¡considera darle una estrella ⭐ en GitHub! Esto ayuda a otros a descubrirlo y fomenta su desarrollo.
¡Agradecemos las contribuciones de la comunidad! Si has encontrado un error, tienes una solicitud de función o quieres contribuir con código, puedes ayudar de esta manera:
¡Todas las contribuciones, grandes o pequeñas, son muy apreciadas!
Si considera que esta herramienta es valiosa para su flujo de trabajo, considere apoyar el proyecto .
Aquí encontrará respuestas a algunas preguntas frecuentes. Para obtener una lista más completa de preguntas frecuentes, consulte nuestro documento de preguntas frecuentes .
Es una herramienta MCP que permite a Claude Desktop acceder a su sistema de archivos y terminal, convirtiendo a Claude en un asistente versátil para codificación, automatización, exploración de base de código y más.
A diferencia de las herramientas centradas en IDE, Claude Desktop Commander ofrece un enfoque centrado en soluciones que funciona con todo el sistema operativo, no solo en un entorno de programación. Claude lee los archivos completos en lugar de fragmentarlos, puede trabajar en varios proyectos simultáneamente y ejecuta los cambios de una sola vez, sin necesidad de una revisión constante.
No. Esta herramienta funciona con la suscripción Pro estándar de Claude Desktop ($20/mes), no con llamadas API, por lo que no incurrirá en costos adicionales más allá de la tarifa de suscripción.
Sí, al instalarlo mediante npx o Smithery, Desktop Commander se actualiza automáticamente a la última versión al reiniciar Claude. No es necesario realizar ninguna actualización manual.
Únete a nuestro servidor de Discord para recibir soporte de la comunidad, consulta los problemas conocidos en GitHub o consulta las preguntas frecuentes para obtener consejos de solución. También puedes visitar la sección de preguntas frecuentes de nuestro sitio web para una experiencia más intuitiva. Si encuentras un nuevo problema, considera abrir un problema en GitHub con los detalles.
Desktop Commander recopila datos de telemetría anónimos limitados para mejorar la herramienta. No se recopila información personal, contenido de archivos, rutas de archivos ni argumentos de comandos.
La telemetría está habilitada por defecto. Para desactivarla:
Para obtener detalles completos sobre la recopilación de datos, consulte nuestra Política de privacidad .
Instituto Tecnológico de Massachusetts (MIT)
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Permite que la aplicación de escritorio Claude ejecute comandos de terminal y edite archivos en su computadora a través de MCP, con funciones que incluyen ejecución de comandos, administración de procesos y edición de archivos basada en diferencias.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wonderwhy-er/DesktopCommanderMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server