MCP PC Control Server

Мощный сервер протокола Model Context Protocol (MCP), предоставляющий комплексные возможности управления ПК, включая файловые операции, управление директориями, выполнение команд, проверку системы и управление процессами. Разработан для предоставления ИИ-ассистентам (Claude, GPT, Gemini и др.) полного и эффективного контроля над хост-машиной.

Функции

Файловые операции

read_file - Чтение полного содержимого файла с правильной кодировкой
read_file_lines - Чтение определенного диапазона строк из файла (эффективно для больших файлов)
write_file - Создание новых файлов или перезапись существующих
append_to_file - Добавление содержимого в файл без его перезаписи
edit_file - Выполнение точных текстовых правок с выводом diff
copy_file - Копирование файла в новое место (исходный файл сохраняется)
delete_file - Удаление файлов из файловой системы
move_file - Перемещение или переименование файлов и директорий
get_file_info - Получение подробных метаданных файла (размер, временные метки, права доступа, читаемость)

Операции с директориями

create_directory - Создание директорий (поддерживается вложенное создание)
list_directory - Вывод содержимого директории с подробной информацией
delete_directory - Рекурсивное удаление директорий и их содержимого
search_files - Рекурсивный поиск файлов по шаблонам имен

Поиск содержимого

search_in_files - Поиск текста в файлах (аналог grep), с опциональной фильтрацией по шаблонам файлов и режимом без учета регистра

Системные операции

execute_command - Выполнение команд оболочки с опциональной рабочей директорией и настраиваемым тайм-аутом
get_system_info - Получение информации об ОС, процессоре, памяти, времени работы, имени хоста и сетевых интерфейсах
list_processes - Список запущенных процессов с опциональным фильтром по имени
get_environment - Чтение переменных окружения (одной или всех)

Установка

Клонируйте или скачайте этот репозиторий
Установите зависимости:

npm install

Соберите проект:

npm run build

Использование

Запуск сервера

Сервер взаимодействует через stdio и предназначен для использования с MCP-клиентами:

npm start

Настройка в Claude Desktop

Добавьте этот сервер в файл конфигурации Claude Desktop:

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

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

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

Замените /absolute/path/to/first_mcp на фактический абсолютный путь к директории этого проекта.

Настройка с другими ИИ-клиентами

Любой MCP-совместимый клиент (Claude, Cursor, Windsurf, Continue и др.) может подключиться к этому серверу, используя тот же подход с транспортом stdio. Укажите клиенту путь к собранному build/index.js с помощью node.

Пример с npx (Альтернатива)

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

Доступные инструменты

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

Вопросы безопасности

ВНИМАНИЕ: Этот сервер предоставляет мощные возможности работы с файловой системой и выполнения команд.

Доступ к файлам: Может читать, записывать и удалять любые файлы, на которые у процесса есть права доступа
Выполнение команд: Может выполнять произвольные команды оболочки
Отсутствие песочницы: Операции не изолированы и не ограничены

Рекомендации:

Используйте только с доверенными MCP-клиентами
Запускайте с минимально необходимыми правами доступа
Будьте осторожны с инструментами execute_command и delete_directory
Рассмотрите возможность внедрения дополнительных средств контроля доступа для промышленного использования
Проверяйте все операции в чувствительных средах

Разработка

Сборка

npm run build

Режим отслеживания (Watch Mode)

npm run watch

Структура проекта

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

Лицензия

MIT

Участие в разработке

Приветствуются любые вклады! Пожалуйста, не стесняйтесь отправлять issues или pull requests.

Устранение неполадок

Сервер не отображается в Claude Desktop

Убедитесь, что путь в claude_desktop_config.json является абсолютным и правильным
Проверьте, что директория сборки существует и содержит index.js
Перезапустите Claude Desktop после внесения изменений в конфигурацию
Проверьте логи Claude Desktop на наличие ошибок

Ошибки прав доступа

Убедитесь, что процесс сервера имеет необходимые права доступа к файловой системе
В Unix-системах проверьте права доступа к файлам/директориям с помощью ls -la
Запускайте с соответствующими привилегиями пользователя для необходимых операций

Проблемы с выполнением команд

Убедитесь, что рабочая директория существует и доступна
Проверьте, подходят ли команды оболочки для вашей операционной системы
Увеличьте параметр timeout для длительных команд
Некоторые команды могут требовать специфических переменных окружения