Claude Desktop Commander MCP

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

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

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!

Licencia

Instituto Tecnológico de Massachusetts (MIT)