Skip to main content
Glama
MCP PC Control Server

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

  1. Klonen oder laden Sie dieses Repository herunter

  2. Abhängigkeiten installieren:

npm install
  1. 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
}
{ path: string, pattern: string }  // pattern supports * and **
{
  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

  1. Überprüfen Sie, ob der Pfad in claude_desktop_config.json absolut und korrekt ist

  2. Stellen Sie sicher, dass das Build-Verzeichnis existiert und index.js enthält

  3. Starten Sie Claude Desktop nach Konfigurationsänderungen neu

  4. Ü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

Available Tools

11 tools
create_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

    A4.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      Enables AI models to perform file system operations (reading, creating, and listing files) on a local file system through a standardized Model Context Protocol interface.
      3
      ISC
    • F
      license
      Not graded
      quality
      C
      maintenance
      A 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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      7
      16 npm
      6
      Apache 2.0