MCP PC Control Server
MCP PC-Steuerungsserver
Ein leistungsstarker Model Context Protocol (MCP)-Server, der umfassende PC-Steuerungsfunktionen bietet, einschließlich Dateioperationen, Verzeichnisverwaltung, Befehlsausführung, Systeminspektion und Prozessverwaltung. Entwickelt, um KI-Assistenten (Claude, GPT, Gemini usw.) die volle und effiziente Kontrolle über den Host-Rechner zu geben.
Funktionen
Dateioperationen
read_file - Vollständigen Dateiinhalt mit korrekter Kodierung lesen
read_file_lines - Einen bestimmten Zeilenbereich aus einer Datei lesen (effizient bei großen Dateien)
write_file - Neue Dateien erstellen oder bestehende überschreiben
append_to_file - Inhalt an eine Datei anhängen, ohne sie zu überschreiben
edit_file - Präzise textbasierte Bearbeitungen mit Diff-Ausgabe vornehmen
copy_file - Eine Datei an einen neuen Ort kopieren (Quelle bleibt erhalten)
delete_file - Dateien aus dem Dateisystem entfernen
move_file - Dateien und Verzeichnisse verschieben oder umbenennen
get_file_info - Detaillierte Dateimetadaten abrufen (Größe, Zeitstempel, Berechtigungen, Lesbarkeit)
Verzeichnisoperationen
create_directory - Verzeichnisse erstellen (unterstützt verschachtelte Erstellung)
list_directory - Verzeichnisinhalt mit detaillierten Informationen auflisten
delete_directory - Verzeichnisse und deren Inhalt rekursiv löschen
search_files - Rekursive Suche nach Dateien, die Namensmustern entsprechen
Inhaltssuche
search_in_files - Grep-ähnliche Suche nach Textinhalten in Dateien, mit optionaler Dateimusterfilterung und Modus für Groß-/Kleinschreibung
Systemoperationen
execute_command - Shell-Befehle mit optionalem Arbeitsverzeichnis und konfigurierbarem Timeout ausführen
get_system_info - OS-, CPU-, Speicher-, Betriebszeit-, Hostname- und Netzwerkschnittstellendetails abrufen
list_processes - Laufende Prozesse mit optionalem Namensfilter auflisten
get_environment - Umgebungsvariablen lesen (einzeln oder alle)
Related MCP server: Enhanced File Operations MCP Server
Installation
Klonen oder laden Sie dieses Repository herunter
Abhängigkeiten installieren:
npm installProjekt bauen:
npm run buildVerwendung
Ausführen des Servers
Der Server kommuniziert über stdio und ist für die Verwendung mit MCP-Clients konzipiert:
npm startKonfiguration mit Claude Desktop
Fügen Sie diesen Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:
Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Unter Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"pc-control": {
"command": "node",
"args": ["/absolute/path/to/first_mcp/build/index.js"]
}
}
}Ersetzen Sie /absolute/path/to/first_mcp durch den tatsächlichen absoluten Pfad zu diesem Projektverzeichnis.
Konfiguration mit anderen KI-Clients
Jeder MCP-kompatible Client (Claude, Cursor, Windsurf, Continue usw.) kann sich über denselben stdio-Transportansatz mit diesem Server verbinden. Verweisen Sie den Client mit node auf die gebaute build/index.js.
Beispiel mit npx (Alternative)
{
"mcpServers": {
"pc-control": {
"command": "npx",
"args": ["-y", "mcp-pc-control-server"]
}
}
}Verfügbare Tools
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 varsSicherheitshinweise
WARNUNG: Dieser Server bietet leistungsstarke Funktionen für das Dateisystem und die Befehlsausführung.
Dateizugriff: Kann alle Dateien lesen, schreiben und löschen, für die der Prozess Berechtigungen hat
Befehlsausführung: Kann beliebige Shell-Befehle ausführen
Kein Sandboxing: Operationen sind nicht in einer Sandbox isoliert oder eingeschränkt
Empfehlungen:
Nur mit vertrauenswürdigen MCP-Clients verwenden
Mit minimal erforderlichen Berechtigungen ausführen
Seien Sie vorsichtig mit den Tools
execute_commandunddelete_directoryErwägen Sie die Implementierung zusätzlicher Zugriffskontrollen für den Produktionseinsatz
Überprüfen Sie alle Vorgänge in sensiblen Umgebungen
Entwicklung
Build
npm run buildWatch-Modus
npm run watchProjektstruktur
.
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.mdLizenz
MIT
Mitwirken
Beiträge sind willkommen! Bitte zögern Sie nicht, Issues oder Pull Requests einzureichen.
Fehlerbehebung
Server erscheint nicht in Claude Desktop
Überprüfen Sie, ob der Pfad in
claude_desktop_config.jsonabsolut und korrekt istStellen Sie sicher, dass das Build-Verzeichnis existiert und
index.jsenthältStarten Sie Claude Desktop nach Konfigurationsänderungen neu
Überprüfen Sie die Claude Desktop-Protokolle auf Fehler
Berechtigungsfehler
Stellen Sie sicher, dass der Serverprozess über die erforderlichen Dateisystemberechtigungen verfügt
Überprüfen Sie auf Unix-Systemen die Datei-/Verzeichnisberechtigungen mit
ls -laFühren Sie den Prozess mit den entsprechenden Benutzerrechten für die benötigten Vorgänge aus
Probleme bei der Befehlsausführung
Überprüfen Sie, ob das Arbeitsverzeichnis existiert und zugänglich ist
Stellen Sie sicher, dass die Shell-Befehle für Ihr Betriebssystem geeignet sind
Erhöhen Sie den
timeout-Parameter für lang laufende BefehleEinige Befehle erfordern möglicherweise bestimmte Umgebungsvariablen
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