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

Related MCP server: Claude Desktop Commander MCP

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 :

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

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

Simplemente ejecute esto en la terminal

npx @wonderwhy-er/desktop-commander setup

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):

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Reiniciar Claude si se está ejecutando

Opción 4: Pagar localmente

1. Clonar y construir:

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

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:

filepath.ext
<<<<<<< SEARCH
existing code to replace
=======
new code to insert
>>>>>>> REPLACE

Ejemplo:

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

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)