MCP-сервер Evolution Managed RAG
Agentic RAG Telegram Bot + MCP Managed RAG
Учебный MCP-сервер Cloud.ru поверх Evolution Managed RAG: отдает агенту контекст из базы знаний, в комплекте пример Telegram-бота на GigaChat
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Использует ключи сервисного аккаунта Cloud.ru с доступом к базе знаний проекта
- Telegram-бот из примера отправляет сообщения от имени бота пользователям чата
Установка
Ручная установка
docker compose up --buildПоднимает оба сервиса из README. Перед запуском задайте переменные окружения бота и MCP-сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из двух сервисов. mcp-managed-rag поднимает MCP-сервер по SSE с одним инструментом request_to_rag: он обращается к уже настроенной базе знаний Evolution Managed RAG в Cloud.ru, форматирует найденные документы в контекст и отдает его агенту. bot-managed-rag показывает, как этим MCP-инструментом пользуется Telegram-бот на LangGraph с GigaChat: пользователь пишет боту, ReAct-агент вызывает удаленный MCP-инструмент и стримит ответ обратно в Telegram, редактируя сообщение по мере генерации.
Для кого. Для тех, у кого уже есть база знаний в Cloud.ru Evolution Managed RAG и нужен пример MCP-обертки и Telegram-бота поверх нее.
Подходит, если
- Уже настроена база знаний в Evolution Managed RAG и нужен MCP-доступ к ней для агента
- Нужен рабочий пример Telegram-бота с RAG на GigaChat и LangGraph
- Нужен образец SSE MCP-сервера для деплоя своего инструмента в Cloud.ru
Не подходит, если
- Нет своей базы знаний в Evolution Managed RAG: без нее сервер использовать не из чего
- Нужен готовый публичный сервер: оба сервиса нужно развернуть и настроить самостоятельно
Пример запроса к агенту
Найди в базе знаний ответ на вопрос про условия возврата и перескажи своими словамиОграничения
Учебный лабораторный проект Cloud.ru, требует уже созданный проект и базу знаний Evolution Managed RAG с ключами сервисного аккаунта, а также доступ к GigaChat API и токен Telegram-бота для примера бота. Транспорт MCP пока только SSE. Больше года без пушей и без обновлений.
Как отключить. Остановите сервисы командой docker compose down и уберите MCP-сервер из конфигурации клиента.
MCP
- Транспорт
- sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| EVOLUTION_PROJECT_ID обязательная | ID проекта Evolution в Cloud.ru. |
| KNOWLEDGE_BASE_ID обязательная | ID базы знаний Managed RAG. |
| KNOWLEDGE_BASE_VERSION_ID обязательная | ID версии базы знаний. |
| SERVICE_ACCOUNT_KEY_ID секрет | ID ключа сервисного аккаунта Cloud.ru. |
| SERVICE_ACCOUNT_KEY_SECRET секрет | Секрет ключа сервисного аккаунта Cloud.ru. |
| GIGACHAT_CREDENTIALS обязательная, секрет | Ключ авторизации GigaChat для примера Telegram-бота. |
| TELEGRAM_BOT_TOKEN обязательная, секрет | Токен Telegram-бота для примера bot-managed-rag. |
Проверка безопасности
- Использует ключи сервисного аккаунта Cloud.ru с доступом к базе знаний проекта
- Telegram-бот из примера отправляет сообщения от имени бота пользователям чата
Коротко о README
README на русском описывает архитектуру из двух сервисов и путь запроса от Telegram до Managed RAG и обратно, перечисляет все переменные окружения для бота и MCP-сервера отдельно и дает команду docker compose up --build для быстрого старта.
Частые вопросы
Обязательно ли разворачивать Telegram-бота?
Нет, bot-managed-rag это лишь пример клиента. MCP-сервер mcp-managed-rag можно подключить напрямую к любому MCP-клиенту по SSE.
Нужна ли отдельная база знаний?
Да, сервер только читает уже существующую базу знаний Evolution Managed RAG, создавать и наполнять ее нужно отдельно в Cloud.ru.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента