👤 Сам, руками — читай этот README по порядку: подготовка VPS → установка → настройка в Telegram.
🤖 Через AI-агента (Claude Code, Cursor и т.п.) — открой AGENTS.md. Там протокол под автоматизацию: какие три значения спросить у пользователя, как запустить установщик через SSH, как проверить успех.
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Sterne
13
Tools
—
Uptime
—
Что нужно
VPS — Ubuntu 22.04+, 1 GB RAM. Заходишь как угодно: пароль, ключ,
web-консоль панели хостера — без разницы.
Telegram-бот — создай у @BotFather, сохрани токен.
Купил VPS, есть только IP + root + пароль? Я опубликовал отдельный скилл
для безопасной первичной настройки сервера: создаст non-root юзера, сгенерит
SSH-ключ, поднимет firewall и заблокирует root + парольный SSH в самом
конце — только после того, как новый ключ проверенно работает с твоего
ноута. Lockout-by-typo структурно невозможен.
2. Открой Claude Code и опиши задачу человеческими словами:
Купил VPS, вот письмо хостера, защити сервер.
Скилл проведёт через 14 шагов: от welcome-email до hardened production-ready
сервера. Подробности — README скилла.
После этого возвращайся сюда и продолжай установкой.
Установка
Зайди на VPS любым удобным способом и выполни прямо там:
git clone https://github.com/AndyShaman/Soroka.git soroka
cd soroka
./bin/install
Скрипт спросит две вещи: токен бота и твой Telegram-ID. Поставит Docker
(если ещё нет), запустит контейнер soroka-bot и пропишет soroka-mcp в
/usr/local/bin/. Никакого rsync, --vps, ssh-copy-id — всё работает
прямо там, где ты сейчас сидишь.
После завершения открой Telegram, найди своего бота и отправь /start —
мастер проведёт через 6 шагов настройки в чате.
Команды бота
/start — мастер настройки (запускается один раз; повтор возобновляет с прерванного шага)
/help — справка
/status — текущие настройки и статистика
/setjina, /setdeepgram, /setkey — заменить отдельный ключ
/models — выбрать основную/fallback LLM
/setgithub — заменить GitHub-токен и репо-зеркало
/setvps — задать IP/юзера VPS (используется в /mcp)
/setinbox — сменить канал-инбокс
/export — выгрузить базу архивом
/sync — синхронизировать сообщения канала, пометить удалённые записи
/purge_list [дней] — составить список «к удалению» без удаления данных
/purge_list_ext [дней] — составить подробный список «к удалению» с фрагментами всех записей
/purge [дней] — физически удалить записи, помеченные на удаление не менее указанного числа дней назад
/mcp — конфиг для Claude Desktop (MCP-сервер по SSH stdio)
/cancel — прервать мастер/диалог
Архитектура
Канал «Избранное 2» ──→ Бот на VPS ──→ SQLite (FTS5 + sqlite-vec)
DM с ботом ──↗ ↑
│
Claude Desktop через MCP-stdio ──SSH──┘
Обновление
Зайди на VPS, перейди в папку с репо и выполни:
cd ~/soroka # или туда, куда ты делал git clone
./bin/update
Подтянет последний код через git pull, пересоберёт контейнер, обновит
soroka-mcp. Никаких аргументов.
Резервное копирование
Авто-бэкап (если GitHub-зеркало подключено): раз в сутки бот собирает
lite-архив (только SQLite-база, без вложений) и заливает в один и тот же
тег soroka-daily-latest в приватном репо — старый релиз
перезаписывается, размер репо не растёт.
Ручной /export собирает базу + вложения в zip:
≤ 50 MB — приходит прямо в Telegram.
> 50 MB — без GitHub-зеркала: бот пришлёт «облегчённый» архив (только база) и
попросит включить зеркало через /setgithub. С зеркалом: заливает полный архив
GitHub Release в твой приватный репо и пришлёт ссылку плюс облегчённый локально.
Для AI-агентов
См. AGENTS.md — там точный протокол развёртывания через флаги.
Лицензия
MIT.
S
Soroka
AndyShaman·13 Sterne·
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Fragen
Wie installiere ich Soroka?
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt Soroka einen API-Schlüssel?
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Welchen Transport verwendet Soroka?
Soroka läuft lokal über stdio.
Wann wurde Soroka zuletzt geprüft?
Zuletzt geprüft: 2026-10-28. Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.