Servidor de control de PC MCP

Un potente servidor del Protocolo de Contexto de Modelo (MCP) que proporciona capacidades integrales de control de PC, incluyendo operaciones de archivos, gestión de directorios, ejecución de comandos, inspección del sistema y gestión de procesos. Diseñado para dar a los asistentes de IA (Claude, GPT, Gemini, etc.) un control total y eficiente sobre la máquina anfitriona.

Características

Operaciones de archivos

read_file - Leer el contenido completo de un archivo con la codificación adecuada
read_file_lines - Leer un rango específico de líneas de un archivo (eficiente para archivos grandes)
write_file - Crear nuevos archivos o sobrescribir los existentes
append_to_file - Añadir contenido a un archivo sin sobrescribirlo
edit_file - Realizar ediciones de texto precisas con salida de diferencias (diff)
copy_file - Copiar un archivo a una nueva ubicación (la fuente se conserva)
delete_file - Eliminar archivos del sistema de archivos
move_file - Mover o renombrar archivos y directorios
get_file_info - Obtener metadatos detallados del archivo (tamaño, marcas de tiempo, permisos, legibilidad)

Operaciones de directorio

create_directory - Crear directorios (admite creación anidada)
list_directory - Listar el contenido del directorio con información detallada
delete_directory - Eliminar recursivamente directorios y su contenido
search_files - Buscar recursivamente archivos que coincidan con patrones de nombre

Búsqueda de contenido

search_in_files - Búsqueda tipo grep para contenido de texto dentro de archivos, con filtrado opcional por patrón de archivo y modo insensible a mayúsculas/minúsculas

Operaciones del sistema

execute_command - Ejecutar comandos de shell con directorio de trabajo opcional y tiempo de espera configurable
get_system_info - Obtener detalles del SO, CPU, memoria, tiempo de actividad, nombre de host e interfaz de red
list_processes - Listar procesos en ejecución con filtro de nombre opcional
get_environment - Leer variables de entorno (una o todas)

Instalación

Clona o descarga este repositorio
Instala las dependencias:

npm install

Construye el proyecto:

npm run build

Uso

Ejecución del servidor

El servidor se comunica a través de stdio y está diseñado para ser utilizado con clientes MCP:

npm start

Configuración con Claude Desktop

Añade este servidor a tu archivo de configuración de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pc-control": {
      "command": "node",
      "args": ["/absolute/path/to/first_mcp/build/index.js"]
    }
  }
}

Reemplaza /absolute/path/to/first_mcp con la ruta absoluta real a este directorio del proyecto.

Configuración con otros clientes de IA

Cualquier cliente compatible con MCP (Claude, Cursor, Windsurf, Continue, etc.) puede conectarse a este servidor utilizando el mismo enfoque de transporte stdio. Apunta el cliente al archivo build/index.js construido con node.

Ejemplo con npx (Alternativa)

{
  "mcpServers": {
    "pc-control": {
      "command": "npx",
      "args": ["-y", "mcp-pc-control-server"]
    }
  }
}

Herramientas disponibles

read_file

{ path: string }

read_file_lines

{
  path: string,
  start: number,  // 1-based, inclusive
  end?: number    // 1-based, inclusive (omit to read to end)
}

write_file

{ path: string, content: string }

append_to_file

{ path: string, content: string }

edit_file

{
  path: string,
  edits: [{ oldText: string, newText: string }]
}

copy_file

{ source: string, destination: string }

create_directory

{ path: string }

list_directory

{ path: string }

delete_file

{ path: string }

delete_directory

{ path: string }

move_file

{ source: string, destination: string }

get_file_info

{ path: string }

execute_command

{
  command: string,
  workingDirectory?: string,
  timeout?: number  // ms, default 30000
}

search_files

{ path: string, pattern: string }  // pattern supports * and **

search_in_files

{
  path: string,
  query: string,
  filePattern?: string,     // e.g. "*.ts"
  caseSensitive?: boolean   // default false
}

get_system_info

{}  // no arguments required

list_processes

{ filter?: string }  // optional substring filter on process name

get_environment

{ variable?: string }  // omit to get all env vars

Consideraciones de seguridad

ADVERTENCIA: Este servidor proporciona capacidades potentes de sistema de archivos y ejecución de comandos.

Acceso a archivos: Puede leer, escribir y eliminar cualquier archivo para el que el proceso tenga permisos
Ejecución de comandos: Puede ejecutar comandos de shell arbitrarios
Sin aislamiento (Sandboxing): Las operaciones no están aisladas ni restringidas

Recomendaciones:

Úsalo solo con clientes MCP de confianza
Ejecútalo con los permisos mínimos necesarios
Ten cuidado con las herramientas execute_command y delete_directory
Considera implementar controles de acceso adicionales para su uso en producción
Revisa todas las operaciones en entornos sensibles

Desarrollo

Construcción

npm run build

Modo de vigilancia (Watch Mode)

npm run watch

Estructura del proyecto

.
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

Licencia

MIT

Contribución

¡Las contribuciones son bienvenidas! Por favor, siéntete libre de enviar problemas o solicitudes de extracción (pull requests).

Solución de problemas

El servidor no aparece en Claude Desktop

Comprueba que la ruta en claude_desktop_config.json sea absoluta y correcta
Verifica que el directorio de construcción exista y contenga index.js
Reinicia Claude Desktop después de realizar cambios en la configuración
Revisa los registros de Claude Desktop en busca de errores

Errores de permisos

Asegúrate de que el proceso del servidor tenga los permisos necesarios del sistema de archivos
En sistemas Unix, verifica los permisos de archivo/directorio con ls -la
Ejecuta con los privilegios de usuario adecuados para las operaciones que necesites

Problemas de ejecución de comandos

Verifica que el directorio de trabajo exista y sea accesible
Comprueba que los comandos de shell sean apropiados para tu sistema operativo
Aumenta el parámetro timeout para comandos de larga duración
Algunos comandos pueden requerir variables de entorno específicas