Control MCP

Servidor de control de Windows para el Protocolo de Contexto de Modelo, que proporciona control programático sobre las operaciones del sistema, incluidas las funciones de mouse, teclado, administración de ventanas y captura de pantalla.

Desarrollé este proyecto como experimento hace unos meses, con la intención de ver si Claude podía jugar videojuegos. Tras verlo funcionar, me impresionó, pero lo dejé de lado. Recientemente, la comunidad le ha prestado atención, lo que me ha impulsado a retomar el desarrollo. Aunque actualmente se encuentra en fase de prelanzamiento, estoy trabajando activamente para obtener una versión estable. Si encuentra algún problema, por favor, infórmelo a través del rastreador de problemas.

Nota : Este proyecto actualmente sólo es compatible con Windows.

⚠️ DESCARGO DE RESPONSABILIDAD IMPORTANTE

ESTE SOFTWARE ES EXPERIMENTAL Y POTENCIALMENTE PELIGROSO

Al utilizar este software, usted reconoce y acepta que:

• Dar a los modelos de IA control directo sobre su computadora a través de esta herramienta es inherentemente riesgoso.
• Este software puede controlar el mouse, el teclado y otras funciones del sistema, lo que podría causar consecuencias no deseadas.
• Usted utiliza este software bajo su propio riesgo.
• Los creadores y colaboradores de este proyecto NO aceptan ninguna responsabilidad por daños, pérdida de datos u otras consecuencias que puedan surgir del uso de este software.
• Esta herramienta solo debe utilizarse en entornos controlados con medidas de seguridad adecuadas implementadas.

ÚSELO BAJO SU PROPIA RESPONSABILIDAD

Características

• Gestión de ventanas
  • Listar todas las ventanas
  • Obtener información de la ventana activa
  • Obtener títulos de ventanas
  • Obtener el tamaño y la posición de la ventana
  • Ventanas de enfoque
  • Cambiar el tamaño de las ventanas
  • Reposicionar ventanas
• Control del ratón
  • Movimiento del ratón
  • Operaciones de clic
  • Funcionalidad de desplazamiento
  • Operaciones de arrastre
  • Seguimiento de la posición del cursor
• Control del teclado
  • Entrada de texto
  • Combinaciones de teclas
  • Operaciones de pulsación y liberación de teclas
  • Funcionalidad de tecla de retención
• Operaciones de pantalla
  • Captura de pantalla
  • Recuperación del tamaño de la pantalla
  • Detección de ventana activa
• Integración del portapapeles
  • Obtener el contenido del portapapeles
  • Establecer el contenido del portapapeles
  • Borrar el portapapeles
  • Comprobar el estado del portapapeles

Uso

Simplemente configure los ajustes de Claude MCP para usar MCPControl como se muestra en la sección Configuración del servidor MCP . ¡No requiere instalación!

Construyendo desde la fuente

Si está interesado en contribuir o desarrollar desde la fuente, consulte CONTRIBUTING.md para obtener instrucciones detalladas.

Requisitos de desarrollo

Para desarrollar este proyecto, necesitarás:

1. Sistema operativo Windows (necesario para la dependencia de keysender)
2. Node.js 18 o posterior (instale utilizando el instalador oficial de Windows que incluye herramientas de compilación)
3. gestor de paquetes npm
4. Herramientas de compilación nativas:
   • node-gyp: npm install -g node-gyp
   • cmake-js: npm install -g cmake-js

La dependencia de keysender depende de módulos nativos específicos de Windows que requieren estas herramientas de compilación.

Configuración del servidor MCP

Para utilizar este proyecto, necesitarás las herramientas de compilación necesarias:

1. Instale Node.js utilizando el instalador oficial de Windows, que incluye las herramientas de compilación necesarias
2. Instalar herramientas adicionales necesarias:

Luego, agregue la siguiente configuración a la configuración de MCP:

Después de configurar los ajustes de MCP, reinicie su cliente para ver el servicio MCPControl en el menú.

Estructura del proyecto

• /src
  • /handlers - Controladores de solicitudes y gestión de herramientas
  • /tools - Implementaciones de funcionalidades principales
  • /types - Definiciones de tipos de TypeScript
  • index.ts - Punto de entrada principal de la aplicación

Dependencias

• @modelcontextprotocol/sdk - SDK de MCP para la implementación del protocolo
• keysender : biblioteca de automatización de interfaz de usuario exclusiva para Windows
• clipboardy - Manejo del portapapeles
• Sharp - Procesamiento de imágenes
• uuid - Generación de UUID

Pruebas

El proyecto actualmente incluye pruebas unitarias para la funcionalidad principal. Se prevé el desarrollo futuro de las siguientes áreas de prueba:

• Pruebas de integración para la funcionalidad entre módulos
• Pruebas de rendimiento
• Validación del manejo de errores

Limitaciones conocidas

• Las operaciones de minimizar/restaurar ventanas no son compatibles actualmente
• Es posible que las funciones de varias pantallas no funcionen como se espera, según la configuración
• La utilidad get_screenshot no funciona con la extensión Cline de VS Code. Consulte el problema n.° 1865 de GitHub.
• Algunas operaciones pueden requerir permisos elevados según la aplicación de destino
• Sólo se admite Windows

Contribuyendo

Ver CONTRIBUTING.md

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Referencias

• Documentación del protocolo de contexto del modelo