Allows the MCP server to send messages, reminders, and daily summaries directly through the Telegram Bot API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Журнал запиши обед: гречка с курицей"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Обвязка для Telegram-агента «Быт» на платформе AI-агентов Timeweb Cloud. Даёт агенту то, чего у платформы нет: журнал с цифрами, точный православный календарь, напоминания по расписанию и доставку точных текстов мимо модели.
Часть | Что делает |
| MCP-сервер «Журнал» — инструменты агента: записать еду/воду/тренировку/отметку, прочитать итог, завести напоминание, сохранить и отправить точный текст |
| Часы: раз в минуту складывает в очередь то, что подошло по времени, и отправляет очередь |
| Пасха по формуле, посты, сплошные седмицы, двунадесятые праздники |
| Журнал в PostgreSQL (или SQLite для локальной проверки) |
| Отправка в Telegram через Bot API; длинный текст уходит частями |
| Единственный исходящий HTTP-клиент: повторы, таймауты, IPv4 |
| Вызов агента Timeweb, чтобы вечерний итог был написан его голосом |
| Всё вместе: HTTP-сервис на порту 8080, |
Related MCP server: Lifestyle MCP Gym
Ничего не отправляется на месте. Всё, что сервис говорит человеку, кладётся в таблицу outbox,
а единственный воркер в планировщике забирает очередь, шлёт и повторяет при сбое (до пяти раз
с растущей паузой). Отсюда три следствия: вызов инструмента не ждёт Telegram и не упирается
в таймаут; длинный текст режется на части при отправке, а не обрывается; журнал доставки
пишется в одном месте, и агент видит в context, что именно сервис уже прислал.
Системные и заведённые человеком события лежат в одной таблице events. У события четыре стрелки:
Поле | Что это |
| когда: время и дни, либо «не чаще чем раз в N часов, не больше M раз в день» |
| условие: пусто (просто по времени) либо имя из закрытого списка — |
| документ: |
| отметка: что записать в журнал, когда человек ответит. Пока ответа нет, агент видит в |
Условия и вычисления — короткий закрытый список в коде: сделать их данными значит завести
свой язык, а это дороже задачи. Всё остальное — данные: агент заводит, меняет и выключает
события через add_event / edit_event / remove_event, без правки кода и без развёртывания.
Разовые напоминания живут отдельно (remind_me): у них нет ни условия, ни документа, только время.
reminders_sent гарантирует, что событие уходит один раз в день.
Таблица texts: молитвенное правило, программа тренировок, любой текст, который должен дойти
слово в слово. Агент его не пересказывает и даже не получает — только сохраняет (saved_text)
и отправляет (send_saved_text). Так текст не обрывается по лимиту ответа и не переписывается.
Базовое расписание — дни недели в настройке workout_days. Перенос, пропуск и дополнительная
тренировка живут в таблице workout_exceptions и заводятся через move_workout. Вечером,
если тренировка в плане и не записана, сервис спрашивает о ней сам.
См. .env.example. Обязательные: TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, MCP_TOKEN,
DATABASE_URL. AGENT_API_URL и AGENT_API_TOKEN — по желанию: без них вечерний итог уходит
сухой сводкой.
В панели агента → MCP-серверы → добавить: URL https://<домен приложения>/mcp, транспорт
Streamable HTTP, авторизация Bearer, токен = MCP_TOKEN. После обновления кода: «Обновить
методы», затем включить новые инструменты — они приходят выключенными.
pip install -r requirements.txt
MCP_TOKEN=test python main.pyБез DATABASE_URL журнал пишется в файл byt.db рядом.
This server cannot be deployed
Manage your Health Partner account, log food, water, workouts, body using agent
Agent-first strength-training platform across iOS, Web & MCP: read & write workouts, PRs & plans.
Manage fitness coaching clients, workouts, programs, chats and funnels from your assistant.
Let AI agents query data and act across all your business apps via MCP.
