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)

Installation

Klonen oder laden Sie dieses Repository herunter
Abhängigkeiten installieren:

npm install

Projekt bauen:

npm run build

Verwendung

Ausführen des Servers

Der Server kommuniziert über stdio und ist für die Verwendung mit MCP-Clients konzipiert:

npm start

Konfiguration 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 required

list_processes

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

get_environment

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

Sicherheitshinweise

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_command und delete_directory
Erwägen Sie die Implementierung zusätzlicher Zugriffskontrollen für den Produktionseinsatz
Überprüfen Sie alle Vorgänge in sensiblen Umgebungen

Entwicklung

Build

npm run build

Watch-Modus

npm run watch

Projektstruktur

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

Lizenz

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.json absolut und korrekt ist
Stellen Sie sicher, dass das Build-Verzeichnis existiert und index.js enthält
Starten 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 -la
Fü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 Befehle
Einige Befehle erfordern möglicherweise bestimmte Umgebungsvariablen