Desktop Commander MCP

Comandante de escritorio MCP

Versión corta. Dos aspectos clave: comandos de terminal y edición de archivos basada en diferencias.

Tabla de contenido

• Características
• Instalación
• Uso
• Manejo de comandos de larga duración
• Trabajo en progreso y tareas pendientes
• Enlaces de medios
• Testimonios
• Contribuyendo
• Licencia

Este es un servidor que permite que la aplicación de escritorio Claude ejecute comandos de terminal de ejecución prolongada en su computadora y administre procesos a través del Protocolo de contexto de modelo (MCP) + Construido sobre el servidor del sistema de archivos MCP para proporcionar capacidades adicionales de búsqueda y reemplazo de edición de archivos.

Características

• Ejecutar comandos de terminal con transmisión de salida
• Compatibilidad con tiempo de espera de comandos y ejecución en segundo plano
• Gestión de procesos (enumerar y eliminar procesos)
• Gestión de sesiones para comandos de larga duración
• Operaciones completas del sistema de archivos:
  • Leer/escribir archivos
  • Crear/enumerar directorios
  • Mover archivos/directorios
  • Buscar archivos
  • Obtener metadatos de archivos
  • Capacidades de edición de código:
  • Reemplazos de texto quirúrgicos para pequeños cambios
  • Reescrituras de archivos completos para cambios importantes
  • Compatibilidad con múltiples archivos
  • Reemplazos basados en patrones

Instalación

Primero, asegúrese de haber descargado e instalado la aplicación Claude Desktop y de tener instalado npm .

Opción 1: Instalación mediante herrería

Para instalar Desktop Commander para Claude Desktop automáticamente a través de Smithery :

Opción 2: Instalar a través de npx

Simplemente ejecute esto en la terminal

Reiniciar Claude si se está ejecutando

Opción 3: Agregar a claude_desktop_config manualmente

Agregue esta entrada a su claude_desktop_config.json (en Mac, se encuentra en ~/Library/Application\ Support/Claude/claude_desktop_config.json):

Reiniciar Claude si se está ejecutando

Opción 4: Pagar localmente

1. Clonar y construir:

Reiniciar Claude si se está ejecutando

El comando de configuración hará lo siguiente:

• Instalar dependencias
• Construir el servidor
• Configurar la aplicación de escritorio de Claude
• Agregue servidores MCP a la configuración de Claude si es necesario

Uso

El servidor proporciona estas categorías de herramientas:

Herramientas de terminal

• execute_command : Ejecuta comandos con tiempo de espera configurable
• read_output : Obtener la salida de comandos de ejecución prolongada
• force_terminate : Detener la ejecución de sesiones de comandos
• list_sessions : Ver sesiones de comando activas
• list_processes : Ver procesos del sistema
• kill_process : Terminar procesos por PID
• block_command / unblock_command : Administrar la lista negra de comandos

Herramientas del sistema de archivos

• read_file / write_file : Operaciones de archivo
• create_directory / list_directory : Gestión de directorios
• move_file : Mover/renombrar archivos
• search_files : Búsqueda de archivos basada en patrones
• get_file_info : Metadatos del archivo

Herramientas de edición

• edit_block : Aplicar reemplazos de texto quirúrgicos (mejor para cambios <20% del tamaño del archivo)
• write_file : reescritura completa de archivos (mejor para cambios grandes >20% o cuando edit_block falla)

Formato de bloque de búsqueda/reemplazo:

Ejemplo:

Manejo de comandos de larga duración

Para comandos que pueden tardar un tiempo:

1. execute_command regresa después del tiempo de espera con la salida inicial
2. El comando continúa en segundo plano
3. Utilice read_output con PID para obtener una nueva salida
4. Utilice force_terminate para detenerlo si es necesario

Integración del protocolo de contexto del modelo

Este proyecto amplía el servidor del sistema de archivos MCP para permitir:

• Compatibilidad con servidores locales en Claude Desktop
• Ejecución completa de comandos del sistema
• Gestión de procesos
• Operaciones con archivos
• Edición de código con bloques de búsqueda y reemplazo

Creado como parte de la exploración de Claude MCP: https://youtube.com/live/TlbjFDbl5Us

Trabajo en progreso y tareas pendientes

Las siguientes características se encuentran actualmente en desarrollo o planificadas:

• Mejor búsqueda de código ( en progreso ): exploración de código mejorada con resultados sensibles al contexto
• Mejores configuraciones ( en progreso ): configuraciones mejoradas para rutas permitidas, comandos y entorno de shell
• Correcciones del entorno de Windows ( en curso ): resolución de problemas específicos de las plataformas Windows
• Mejoras de Linux ( en progreso ): mejora de la compatibilidad con varias distribuciones de Linux
• Compatibilidad con WSL : subsistema de Windows para la integración con Linux
• Compatibilidad con SSH : ejecución de comandos de servidor remoto
• Guía de solución de problemas de instalación : ayuda completa para problemas de configuración

Medios de comunicación

Conozca más sobre este proyecto a través de estos recursos:

Artículo

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.

Video

Tutorial en vídeo de Claude Desktop Commander : vea cómo configurar y utilizar Commander de manera efectiva.

Comunidad

Únase a nuestro servidor Discord para obtener ayuda, compartir comentarios y conectarse con otros usuarios.

Testimonios

Contribuyendo

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:

• ¿Encontraste un error? Abre un problema en github.com/wonderwhy-er/ClaudeComputerCommander/issues
• ¿Tienes una idea para una función? Envía una solicitud en la sección de problemas.
• ¿Quieres contribuir con código? Bifurca el repositorio, crea una rama y envía una solicitud de incorporación de cambios.
• ¿Preguntas o discusiones? Inicia una discusión en la pestaña "Discusiones" de GitHub.

¡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 .

Licencia

Instituto Tecnológico de Massachusetts (MIT)