Claude Desktop Commander MCP

Descargas de npm insignia de herrería

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

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:

execute_command regresa después del tiempo de espera con la salida inicial
El comando continúa en segundo plano
Utilice read_output con PID para obtener una nueva salida
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!