MCP PC Control Server
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)
Related MCP server: Enhanced File Operations MCP Server
Instalación
Clona o descarga este repositorio
Instala las dependencias:
npm installConstruye el proyecto:
npm run buildUso
Ejecución del servidor
El servidor se comunica a través de stdio y está diseñado para ser utilizado con clientes MCP:
npm startConfiguració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 requiredlist_processes
{ filter?: string } // optional substring filter on process nameget_environment
{ variable?: string } // omit to get all env varsConsideraciones 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_commandydelete_directoryConsidera implementar controles de acceso adicionales para su uso en producción
Revisa todas las operaciones en entornos sensibles
Desarrollo
Construcción
npm run buildModo de vigilancia (Watch Mode)
npm run watchEstructura del proyecto
.
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.mdLicencia
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.jsonsea absoluta y correctaVerifica que el directorio de construcción exista y contenga
index.jsReinicia 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 -laEjecuta 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
timeoutpara comandos de larga duraciónAlgunos comandos pueden requerir variables de entorno específicas
Available Tools
11 toolscreate_directoryA
Create a new directory or ensure a directory exists. Can create multiple nested directories in one operation. If the directory already exists, this operation will succeed silently.
Inputs: path (required).
delete_directoryA
Permanently delete a directory and all of its contents, including all files and subdirectories. This is a recursive operation that cannot be undone. Use with extreme caution.
Inputs: path (required).
delete_fileA
Permanently delete a file from the file system. This operation cannot be undone. The file is immediately removed from the storage device.
Inputs: path (required).
edit_fileA
Make line-based edits to a text file. Provide original lines and their replacements. Returns a git-style diff showing the changes made. Each edit replaces exact line sequences with new content.
Inputs: path (required), edits (required).
execute_commandA
Execute shell commands on the system. SECURITY WARNING: This tool provides direct system access. Only use with trusted commands. Commands run with the same permissions as the MCP server process.
Inputs: command (required), workingDirectory.
get_file_infoA
Retrieve detailed metadata about a file or directory, including size, creation time, modification time, access time, type, and permissions. This does not read file contents.
Inputs: path (required).
list_directoryA
Get a detailed listing of all files and directories in a specified path. Results include names, types (file/directory), sizes, and modification times. Useful for understanding directory structure and finding files.
Inputs: path (required).
move_fileA
Move or rename files and directories. Can move files between directories and rename them in a single operation. If the destination exists, the operation will fail.
Inputs: source (required), destination (required).
read_fileA
Read the complete contents of a file from the file system. Handles various text encodings and returns the full file content. Use this to examine file contents before editing.
Inputs: path (required).
search_filesA
Recursively search for files matching a pattern in a directory. Supports wildcards (* and **) and returns matching file paths. Useful for finding files by name or extension.
Inputs: path (required), pattern (required).
write_fileA
Create a new file or completely overwrite an existing file with new content. Use with caution as it will overwrite existing files without warning. Handles text content with proper encoding.
Inputs: path (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose with no ambiguity: create_directory vs. delete_directory, read_file vs. edit_file vs. write_file, list_directory vs. search_files, etc. The descriptions reinforce unique roles, such as get_file_info for metadata only and execute_command for shell operations, preventing misselection.
All tool names follow a consistent verb_noun pattern using snake_case, such as create_directory, delete_file, and execute_command. This predictable naming scheme makes it easy for agents to understand and use the tools without confusion from mixed conventions.
With 11 tools, the server is well-scoped for PC control, covering essential file system operations (CRUD for files/directories), metadata retrieval, searching, and command execution. Each tool earns its place without being overwhelming or insufficient for the domain.
The tool set provides complete coverage for file system management: create, read, edit, write, delete, move, list, search, and get info for files and directories, plus execute_command for broader system control. There are no obvious gaps, enabling agents to handle full workflows without dead ends.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables AI models to perform file system operations (reading, creating, and listing files) on a local file system through a standardized Model Context Protocol interface.3ISC
- FlicenseNot gradedqualityCmaintenanceA comprehensive Model Context Protocol server that provides over 50 file and system management tools for AI models, including navigation, file operations, search, compression, and system information capabilities.-
- AlicenseAqualityDmaintenanceA comprehensive Model Context Protocol server that enables AI assistants to interact with and manage Windows systems, providing capabilities for file system operations, process management, system information retrieval, registry operations, service management, network diagnostics, and performance monitoring.716 npm6Apache 2.0
- AlicenseAqualityDmaintenanceEnables file management operations on the desktop including creating, reading, editing, moving, renaming, deleting, and listing files through the Model Context Protocol.6ISC