MCP 服务器

MCP PC Control Server

Provides comprehensive PC control capabilities including file operations (read, write, edit, delete), directory management, file search, and shell command execution through the Model Context Protocol.

README

MCP PC Control Server

A powerful Model Context Protocol (MCP) server that provides comprehensive PC control capabilities including file operations, directory management, and command execution.

Features

File Operations

read_file - Read complete file contents with proper encoding
write_file - Create new files or overwrite existing ones
edit_file - Make precise line-based edits with diff output
delete_file - Remove files from the filesystem
move_file - Move or rename files and directories
get_file_info - Get detailed file metadata (size, timestamps, permissions)

Directory Operations

create_directory - Create directories (supports nested creation)
list_directory - List directory contents with detailed information
delete_directory - Recursively delete directories and their contents
search_files - Recursively search for files matching patterns

System Operations

execute_command - Execute shell commands with optional working directory

Installation

Clone or download this repository
Install dependencies:

npm install

Build the project:

npm run build

Usage

Running the Server

The server communicates via stdio and is designed to be used with MCP clients:

npm start

Configuration with Claude Desktop

Add this server to your Claude Desktop configuration file:

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

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

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

Replace /absolute/path/to/first_mcp with the actual absolute path to this project directory.

Example with npx (Alternative)

You can also run it directly with npx if published to npm:

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

Available Tools

read_file

{
  path: string  // Path to the file to read
}

write_file

{
  path: string,    // Path where file should be written
  content: string  // Content to write
}

edit_file

{
  path: string,
  edits: [{
    oldText: string,  // Exact text to find
    newText: string   // Replacement text
  }]
}

create_directory

{
  path: string  // Directory path to create
}

list_directory

{
  path: string  // Directory path to list
}

delete_file

{
  path: string  // File path to delete
}

delete_directory

{
  path: string  // Directory path to delete recursively
}

move_file

{
  source: string,      // Current path
  destination: string  // New path
}

get_file_info

{
  path: string  // Path to get info about
}

execute_command

{
  command: string,           // Shell command to execute
  workingDirectory?: string  // Optional working directory
}

search_files

{
  path: string,     // Directory to search in
  pattern: string   // Pattern to match (supports * and **)
}

Security Considerations

WARNING: This server provides powerful filesystem and command execution capabilities.

File Access: Can read, write, and delete any files the process has permissions for
Command Execution: Can execute arbitrary shell commands
No Sandboxing: Operations are not sandboxed or restricted

Recommendations:

Only use with trusted MCP clients
Run with minimal necessary permissions
Be cautious with the execute_command tool
Consider implementing additional access controls for production use
Review all operations in sensitive environments

Development

Build

npm run build

Watch Mode

npm run watch

Project Structure

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