Единый пульт управления компьютером для твоего AI-ассистента
The unified remote control for your AI assistant — terminal, files, Docker, AppleScript, and beyond
Features • Быстрый старт • Installation • Инструменты • Clients
AI Control — это MCP-сервер, который даёт вашему AI-ассистенту полный контроль над компьютером: терминал, файлы, Docker, AppleScript, процессы, PDF/Excel/DOCX, поиск по коду и многое другое. Всё что нужно AI чтобы работать как полноценный разработчик — в одном инструменте.
AI Control is an MCP server that gives your AI assistant full control over your computer — terminal, files, Docker, AppleScript, processes, PDF/Excel/DOCX, code search and more. Everything your AI needs to work like a full-stack developer, in one tool.
AI Control базируется на коде Desktop Commander MCP от Eduards Ruzga и объединяет его с собственными macOS-инструментами. Мы глубоко переработали код, провели ребрендинг, добавили нативные macOS-тулзы (AppleScript, Docker, System Info), почистили зависимости и адаптировали под свой стек.
AI Control is based on Desktop Commander MCP by Eduards Ruzga, merged with our own macOS-native tools. We deeply reworked the code, rebranded, added native macOS tools (AppleScript, Docker, System Info), cleaned up dependencies, and adapted it to our stack.
| Feature | Description |
|---|---|
| AppleScript | Управляй Finder, открывай приложения, показывай диалоги, автоматизируй GUI |
| Docker Control | docker ps, compose up -d, restart nginx — без лишних движений |
| System Info | CPU, память, диск, аптайм — реальное состояние системы в реальном времени |
| Homebrew PATH | Автоматический поиск инструментов в /opt/homebrew |
| Feature | Description |
|---|---|
| Smart REPL | Авто-детект промптов Python, Node.js, R, SSH, баз данных |
| Process Interaction | Отправляй команды в запущенные процессы, читай вывод |
| Output Pagination | read_process_output с offset/length/tail |
| Session Management | list_sessions, force_terminate, kill_process |
| Timeout & Fallback | Если Python не найден — запустит Node.js |
| Feature | Description |
|---|---|
| Read/Write | Любые текстовые файлы с пагинацией строк |
| Чтение (в markdown), создание из MD, вставка/удаление страниц | |
| Excel | Чтение, запись, редактирование ячеек (.xlsx, .xls, .xlsm) |
| DOCX | Чтение, создание, XML-редактирование |
| Images | Просмотр PNG, JPEG, GIF, WebP прямо в чате |
| Code Search | ripgrep: поиск по имени файла или содержимому |
| Edit Block | Хирургическая замена текста с fuzzy matching |
| Bulk Read | Читай несколько файлов одновременно |
| Directory Tree | Рекурсивный листинг с защитой от переполнения контекста |
| Feature | Description |
|---|---|
| Command Blocklist | Блокировка опасных команд (sudo, dd, mkfs...) |
| Bypass Detection | Отлавливает обход через $(), backticks, subshells |
| Symlink Protection | Предотвращает directory traversal |
| Docker Isolation | Полная песочница через Docker |
| Config Restrictions | allowedDirectories для файловых операций |
| Telemetry Opt-Out | Полный контроль над сбором данных |
Шаг 1. Установи глобально:
npm install -g ai-controlШаг 2. Добавь в конфиг Claude Desktop.
Найди файл claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
И добавь этот entry:
{
"mcpServers": {
"ai-control": {
"command": "ai-control"
}
}
}Шаг 3. Перезапусти Claude Desktop.
✅ Готово. Теперь Claude может запускать терминал, читать файлы, работать с Docker и AppleScript.
- Node.js 18+ (скачать: nodejs.org)
- Claude Desktop или любой MCP-клиент
💻 Option 1: Глобальная установка (рекомендуется / recommended)
npm install -g ai-controlПроверьте:
ai-control --version✅ Auto-Updates: npm update -g ai-control
📦 Option 2: Локальная установка / Local build
git clone https://github.com/iLuckyGUY/ai-control.git
cd ai-control
npm install
npm run build
npm run link:local❌ Auto-Updates: Нет — git pull && npm run build
🐳 Option 3: Docker (песочница / sandbox)
Для полной изоляции от хост-системы:
{
"mcpServers": {
"ai-control": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-v", "/Users/username:/mnt/host",
"mcp/ai-control:latest"
]
}
}
}✅ Auto-Updates: docker pull mcp/ai-control:latest
npm update -g ai-controlnpm uninstall -g ai-control
# затем удали entry из claude_desktop_config.jsonAI Control предоставляет 38+ инструментов в 6 категориях:
| Tool | Description |
|---|---|
get_config |
Получить полную конфигурацию сервера |
set_config_value |
Изменить любой параметр (blockedCommands, defaultShell, allowedDirectories...) |
| Tool | Description |
|---|---|
applescript |
Выполнить AppleScript для GUI automation |
docker_command |
Docker / Docker Compose команды |
system_info |
CPU, память, диск, аптайм в реальном времени |
| Tool | Description |
|---|---|
start_process |
Запустить программу/REPL с авто-детектом промпта |
interact_with_process |
Отправить команду в запущенный процесс |
read_process_output |
Читать вывод с пагинацией (offset/length/tail) |
force_terminate |
Принудительно завершить сессию |
list_sessions |
Список всех активных терминальных сессий |
list_processes |
Список всех процессов ОС |
kill_process |
Завершить процесс по PID |
| Tool | Description |
|---|---|
read_file |
Читать текст, PDF, Excel, DOCX, изображения (с пагинацией) |
read_multiple_files |
Читать несколько файлов сразу |
write_file |
Писать/дописывать файлы |
write_pdf |
Создавать и модифицировать PDF |
create_directory |
Создать директорию (рекурсивно) |
list_directory |
Листинг с рекурсией (depth) |
move_file |
Переместить/переименовать |
get_file_info |
Метаданные файла (размер, даты, права, строки) |
start_search |
Поиск файлов или контента через ripgrep |
get_more_search_results |
Дозагрузка результатов поиска |
stop_search |
Остановить активный поиск |
list_searches |
Список активных поисков |
| Tool | Description |
|---|---|
edit_block |
Хирургическая замена текста с fuzzy matching. Замена ячеек в Excel |
| Tool | Description |
|---|---|
get_usage_stats |
Статистика использования |
get_recent_tool_calls |
История вызовов (восстановление контекста) |
give_feedback |
Форма обратной связи |
get_prompts |
Онбординг-промпты для новых пользователей |
AI Control работает с любым MCP-совместимым клиентом:
Claude Desktop
{
"mcpServers": {
"ai-control": {
"command": "ai-control"
}
}
}Cursor
Добавь в ~/.cursor/mcp.json:
{
"mcpServers": {
"ai-control": {
"command": "npx",
"args": ["-y", "ai-control"]
}
}
}VS Code / GitHub Copilot
В .vscode/mcp.json:
{
"mcpServers": {
"ai-control": {
"command": "npx",
"args": ["-y", "ai-control"]
}
}
}Claude Code (CLI)
claude mcp add --scope user ai-control -- npx -y ai-controlWindsurf
В ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"ai-control": {
"command": "npx",
"args": ["-y", "ai-control"]
}
}
}Cline / Roo Code / Trae / Kiro
Добавь MCP server с конфигом:
{
"mcpServers": {
"ai-control": {
"command": "npx",
"args": ["-y", "ai-control"]
}
}
}JetBrains AI Assistant
Settings → Tools → AI Assistant → MCP → + Add → As JSON → вставь конфиг.
Gemini CLI
В ~/.gemini/settings.json:
{
"mcpServers": {
"ai-control": {
"command": "npx",
"args": ["-y", "ai-control"]
}
}
}OpenAI Codex
codex mcp add ai-control -- npx -y ai-control"Проанализируй sales.csv и покажи топ клиентов"
→ Claude запускает Python REPL, загружает pandas в память,
считает статистику и возвращает результат
"Перезапусти nginx и покажи логи"
→ docker_command("restart nginx")
→ docker_command("logs nginx --tail 50")
"Создай папку Reports на рабочем столе и открой её"
→ applescript('tell app "Finder" to make new folder...')
"Проверь состояние системы"
→ system_info → CPU, uptime, память, диск
"Создай PDF-отчёт из этого markdown"
→ write_pdf(path="report.pdf", content="# Отчёт...")
// Посмотреть конфиг
get_config({})
// Сменить shell
set_config_value({ key: "defaultShell", value: "/bin/zsh" })
// Заблокировать команды
set_config_value({ key: "blockedCommands", value: ["sudo", "dd", "mkfs"] })
// Ограничить файловую систему
set_config_value({ key: "allowedDirectories", value: ["/Users/user/projects"] })
// Лимит строк для чтения
set_config_value({ key: "fileReadLineLimit", value: 1000 })
// Отключить телеметрию
set_config_value({ key: "telemetryEnabled", value: false })AI Control собирает минимальную псевдонимную телеметрию — только метаданные использования, без содержимого файлов, путей или аргументов команд.
AI Control collects minimal pseudonymous telemetry — usage metadata only. No file contents, paths, or command arguments are collected.
Отключить / Opt-out: set_config_value({ key: "telemetryEnabled", value: false })
Нужен ли Node.js? / Do I need Node.js?
Да, версия 18+. Если нет — установи с [nodejs.org](https://nodejs.org). *Yes, version 18+. Download from [nodejs.org](https://nodejs.org).*Нужен ли API-ключ? / Do I need an API key?
Нет. AI Control работает с подпиской Claude Pro ($20/мес), не с API. *No. AI Control works with Claude Pro subscription, not API tokens.*Работает ли на Windows и Linux? / Does it work on Windows and Linux?
Да. macOS-фичи (AppleScript, system_info через vm_stat) доступны только на Mac, но всё остальное — терминал, файлы, поиск, процессы — на всех платформах. *Yes. macOS-specific features work on Mac only, but everything else works everywhere.*Как обновить? / How to update?
`npm update -g ai-control` и перезапусти клиент. *Then restart your client.*AI Control vs Desktop Commander?
AI Control — форк [Desktop Commander MCP](https://github.com/wonderwhy-er/DesktopCommanderMCP), объединённый с собственными macOS-инструментами. Код переработан, произведён ребрендинг, добавлены AppleScript, Docker, System Info, обновлена документация. *AI Control is a fork of Desktop Commander MCP merged with our own macOS tools. Rebranded, cleaned up, with added AppleScript/Docker/System Info tools.*PR приветствуются! Форкай, делай ветку, открывай PR.
Темы: новые тулзы, поддержка платформ, баг-фиксы, тесты, документация.
MIT © luckyguy
Основано на Desktop Commander MCP © Eduards Ruzga / MIT
Developed with ❤️ by: