Comandante de escritorio MCP

👁 Comandante de escritorio MCP

👁 Descargas de npm
👁 insignia de herrería
👁 Invítame a un café
👁 Discordia

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.

Related MCP server: MCP Tools

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 :

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

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

👁 ¡Es una maravilla! Actualmente, pagué Claude + Cursor, que siempre me parece un poco duplicado. Esto soluciona el problema por completo. Estoy muy contento. Muchas gracias. Además, hoy Claude ha añadido la compatibilidad con la búsqueda web. Con esta combinación de MCP y búsqueda en Internet, escribe el código con las últimas actualizaciones. Es genial cuando Cursor no funciona a veces o se utilizan todas las solicitudes rápidas.
https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyyBt6\_ShdDX\_rIOad4AaABAg

👁 Este es el primer comentario que dejo en un video de YouTube, ¡GRACIAS! He tenido dificultades para actualizar una aplicación antigua de Flutter en Cursor, de una versión anterior a la seguridad nula, a una versión actual e implementé la seguridad nula con Claude 3.7. Logré casi todo, pero tuve errores críticos de BLE que pasé días intentando resolver sin éxito. Probé Augment Code, pero tampoco lo logré. Implementé tu MCP en Claude Desktop y pude comparar completamente el código base antiguo y el nuevo, considerando las actualizaciones, y solucionar los problemas en un par de horas. Un consejo para quienes intenten esto: asegúrense de preparar los cambios y confirmarlos cuando sea necesario para poder deshacer los cambios no deseados. ¡Genial!
https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgztdHvDMqTb9jiqnf54AaABAg

👁 ¡Genial! Acabo de usar Windsurf (compré la licencia hace una semana) para actualizar un antiguo proyecto de sockets fullstack. Muchas veces funciona bien o aceptablemente, pero también muchas veces se bloquea en cascada y tengo que revertir todos los cambios, perdiendo cientos de tokens. En solo una semana, me quedaban menos de 100 tokens y no quiero comprar solo 300 por 10 $. Compré Claude MCP, pero finalmente lo necesitaba, pero tenía una muy buena razón para tenerlo junto con ChatGPT, y ahora puedo programar todo lo que quiera sin preocuparme por el costo de los tokens. Además, esto es mucho más que editar código; es mucho más. ¡Gracias por el excelente video!
https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyQFTmYLJ4VBwIlmql4AaABAg

👁 Es una gran herramienta, gracias, me gusta usarla, ya que le da a Claude la capacidad de hacer ediciones quirúrgicas, haciéndolo más como un desarrollador humano.
https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=Ugy4-exy166\_Ma7TH-h4AaABAg

👁 Señor, usted es mi héroe. Ha resumido y descrito mis experiencias últimamente mucho mejor de lo que yo podría haberlo hecho. Cursor y Windsurf me frustraron tanto que casi le grité a la pantalla. Por capricho, pensé: "¿Por qué no preguntarle directamente a Claude?", y desde entonces no he vuelto a mirar atrás. Claude primero para mantener mi cordura, y luego, si es necesario, probar otros IDE, frameworks, etc. Pensé que era el único, y me alegra ver que no lo soy, jaja. 33 1
https://medium.com/@pharmx/usted-sir-are-my-hero-62cff5836a3e

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)

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• block_commandA
• create_directoryB
• edit_blockA
• execute_commandC
• force_terminateC
• get_file_infoA
• kill_processA
• list_allowed_directoriesB