English summary

Jarvis is a remote Model Context Protocol connector for Claude. It runs on your own Windows computer and is exposed through an ngrok tunnel, so Claude can list, read, search and write files in folders you allow, and run commands only after you press Allow in the chat.

• Read anything useful: text, Excel, Word, PDF, DBF, zip listings; large files in chunks.

• Safe by default: password login (OAuth, hashed), folder whitelist, read-only folders, automatic backups before overwrite, no delete tool, action log.

• Confirm from your phone: commands and writes ask for approval in the Claude chat.

• Built for your phone: you don't need to sit at the computer — leave it on, and from your phone (chat or voice) tell Claude to find a file, read a document, make a spreadsheet or run a script on your PC.

Quick start (Windows): install Python 3.12+, create a free ngrok account with a static domain, download this repo, run 1_ustanovka.bat, then 2_zapusk.bat, and add https://<your-domain>/mcp as a custom connector in Claude. Detailed instructions below are in Russian.

«Jarvis для Claude»: свой коннектор к компьютеру

Это свой MCP-сервер. Он даёт Claude доступ к вашему компьютеру из чата, с телефона и, если поддерживается, из голосового режима. Работает он так:

Claude (облако) → https://ваш-адрес.ngrok-free.dev/mcp → туннель ngrok → сервер на вашем ПК → ваши папки

Удобнее всего — с телефона. Не нужно сидеть за компьютером: оставьте его включённым и командуйте с телефона, в чате или голосом. Например: «найди на компьютере проект и прочитай его», «сделай таблицу и сохрани в папку», «запусти скрипт». Claude сделает это на вашем ПК, а результат покажет в телефоне.

Компьютер должен быть включён, а Windows должна быть открыта под вашим пользователем.

Related MCP server: Secure Local AI Agent MCP

Что умеет

Защита

• Пароль. Подключить коннектор можно только через страницу входа с вашим паролем. Пароль хранится только в виде хеша.

• Только один владелец. Первый, кто подключился с паролем, становится владельцем; другим аккаунтам Claude сервер отказывает даже с верным паролем. Привязать заново — PRIVYAZAT_ZANOVO.bat.

• Команды (run_command) по умолчанию выключены. Включить: "allow_commands": true в config.json. Команда может обойти белый список папок — включайте, только если нужно, и держите у run_command «Спрашивать» в Claude.

• Запись вне белого списка запрещена (кроме режима popup с подтверждением окном на ПК).

• Блокировка подбора пароля — 5 неверных попыток с одного адреса или 30 со всех за 15 минут.

• Только Claude. Сервер принимает подключение только с адресов возврата claude.ai и claude.com.

• Белый список папок. По умолчанию это Рабочий стол, Документы и Загрузки, остальное закрыто. Список меняется в config.json, поле allowed_folders.

• Папки только для чтения — можно указать в config.json, поле read_only_folders (исключения — writable_exceptions).

• Резервные копии перед каждой перезаписью: папка backups\<дата> рядом с сервером.

• Подтверждение в чате для команд и записи: в настройках коннектора у run_command и write_file ставится «Спрашивать», и Claude перед каждым таким действием показывает кнопку «Разрешить», в том числе на телефоне. Удалять файлы сервер не умеет вообще. Если хотите подтверждать окном на ноутбуке, поставьте в config.json "confirm_mode": "popup".

• Оповещение о попытках подключения. Любая чужая попытка (регистрация, неверный пароль, блокировка) записывается в data\attempts.jsonl с IP, страной, городом, провайдером и браузером; на ПК всплывает окно, а в Claude при следующем обращении появляется предупреждение. Журнал — инструмент access_attempts.

• Журнал всех действий: data\actions.log.

Установка (один раз, около 15 минут)

1. Python

Скачайте Python 3.12 или новее с https://www.python.org/downloads/. При установке поставьте галочку «Add python.exe to PATH».

2. ngrok (туннель с постоянным адресом)

1. Зарегистрируйтесь на https://dashboard.ngrok.com/signup, это бесплатно.

2. Откройте Your Authtoken и держите страницу открытой: токен понадобится при установке.

3. Откройте Domains и получите бесплатный постоянный домен, вида что-то.ngrok-free.dev. Скопируйте его.

3. Файлы

Скачайте репозиторий (Code → Download ZIP) и распакуйте в папку без русских букв и пробелов, например C:\Jarvis.

4. Установка

Запустите 1_ustanovka.bat. Он:

• создаст отдельное окружение Python и поставит библиотеки;

• поставит ngrok (если его нет);

• спросит домен ngrok, Authtoken, пароль и дополнительные папки.

5. Запуск и проверка

Запустите 2_zapusk.bat. Через 10 секунд должно появиться ok, а ниже адрес коннектора вида https://…/mcp.

6. Автозапуск

Запустите 3_avtozapusk_vkl.bat. Теперь сервер будет сам запускаться через 30 секунд после входа в Windows, без окон.

Подключение к Claude

1. На компьютере откройте claude.ai: Настройки → Коннекторы → Добавить свой коннектор.

2. Название: Jarvis. URL: https://ваш-домен.ngrok-free.dev/mcp. Расширенные настройки (Client ID и Secret) оставьте пустыми.

3. Нажмите Добавить, затем Подключить.

4. Откроется браузер. Если ngrok покажет страницу-предупреждение, нажмите Visit Site. На странице «Разрешить доступ к компьютеру» введите пароль и нажмите Разрешить.

5. Коннектор станет «Подключён». С телефона он появится сам, потому что добавленные на сайте коннекторы видны и в приложении.

Проверка

• В обычном чате напишите: «Покажи разрешённые папки на моём ПК», а потом «Найди на рабочем столе все файлы Excel».

• На телефоне повторите то же в чате, затем в голосовом режиме.

• Если голосовой режим не вызывает коннектор, это ограничение самого голосового режима, а не сервера. Тогда пользуйтесь текстовым чатом на телефоне: там коннектор работает.

Как быстро отключить доступ

Никому не сообщайте пароль. С ним можно читать ваши папки.

Если не работает

Файлы: server.py — сервер; launcher.py — фоновый запуск сервера и ngrok с перезапуском при падении; setup.py — настройка; config.json — настройки (создаётся при установке); data\ — журналы и выданные доступы.

Безопасность репозитория

config.json (пароль, токен ngrok) и папка data\ (выданные доступы) не загружаются на GitHub — они в .gitignore. Шаблон настроек — config.example.json. Никогда не выкладывайте свой config.json.

Лицензия

MIT — см. файл LICENSE. Используете на свой риск: сервер даёт удалённый доступ к вашему компьютеру.

Контакты

Вопросы и предложения: aidostoktogulov111@gmail.com