Beever Atlas MCP
MCP-сервер к базе знаний, которую Beever Atlas строит из чатов Slack, Discord, Teams и Mattermost: ответы с цитатами, вики по каналам, граф связей
- 451 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Читает рабочую переписку целиком, а в ней бывают личные данные и коммерческие тайны
- Хранит токены Slack, Discord и Teams, а сообщения уходят выбранному провайдеру LLM на извлечение фактов
- Инструмент trigger_sync запускает синхронизацию каналов, ключ MCP открывает доступ к базе знаний всем, кто им владеет
Установка
- Работает в
Ручная установка
git clone https://github.com/beever-ai/beever-atlas.git && cd beever-atlas && ./atlasУстановщик спрашивает ключи и провайдеров, генерирует секреты и поднимает стек через Docker Compose. Панель открывается на localhost:3000.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает рабочую переписку целиком, а в ней бывают личные данные и коммерческие тайны
- Хранит токены Slack, Discord и Teams, а сообщения уходят выбранному провайдеру LLM на извлечение фактов
- Инструмент trigger_sync запускает синхронизацию каналов, ключ MCP открывает доступ к базе знаний всем, кто им владеет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Beever Atlas забирает переписку команды из Slack, Discord, Microsoft Teams и Mattermost, вытаскивает из нее отдельные факты, убирает повторы и собирает страницы по темам со ссылками на исходные сообщения. Граф в Neo4j связывает людей, решения и проекты из разных каналов. Для каждого канала Atlas ведет вики, которая обновляется по мере новых сообщений, а вопросы на естественном языке получают ответ с цитатами. Агентам Atlas открывает MCP-сервер по адресу /mcp: Claude Code, Cursor и другие клиенты спрашивают базу знаний сами, без панели. В каталоге 28 инструментов: обзор подключений и каналов (whoami, list_connections, list_channels), поиск и вопросы (ask_channel с режимами `quick`, `deep` и `summarize`, search_memory, search_channel_facts), чтение вики по страницам и граф связей, а также запуск синхронизации канала и сессии диалога. Стек поднимается через Docker Compose: бэкенд, бот и веб-панель на порту 3000, а под ними Weaviate, Neo4j, MongoDB и Redis. Есть и облегченный режим: stdio-версия MCP-сервера без хранилищ отдает каталог инструментов, но читать знания без базы не может.
Для кого. Для команд, где решения и договоренности тонут в чатах, и для разработчиков, которые хотят дать Claude Code или Cursor доступ к этой памяти.
Подходит, если
- Новому коллеге нужен краткий обзор канала Slack или Discord вместо трех месяцев переписки
- Агент в Cursor должен ответить на вопрос «как у нас устроена авторизация» по обсуждениям команды
- Нужно найти, кто и когда принял решение, со ссылкой на исходное сообщение
- Чаты приходится подтягивать из нескольких платформ в одну базу знаний
- Хочется проверить набор инструментов MCP без развертывания всего стека: для этого есть stdio-режим
Не подходит, если
- Команда не готова отдавать переписку внешним моделям: извлечение фактов идет через выбранного провайдера LLM
- Нужен один маленький MCP-сервер без баз данных: Atlas поднимает Weaviate, Neo4j, MongoDB и Redis
- Чаты лежат в мессенджерах вне списка Slack, Discord, Teams и Mattermost
- Нужен MCP без TLS: в продакшене сервер /mcp обязан работать по HTTPS
Пример запроса к агенту
Спроси у Atlas по каналу `devops`, почему мы перешли на новый балансировщик, и покажи цитаты из сообщенийMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
BEEVER_MCP_ENABLEDобязательная- true включает точку /mcp, по умолчанию выключена
BEEVER_MCP_API_KEYSобязательная, секрет- Ключи внешних агентов через запятую, по одному на экземпляр агента
GOOGLE_API_KEYобязательная, секрет- Ключ Gemini для извлечения фактов и ответов
JINA_API_KEYобязательная, секрет- Ключ Jina для эмбеддингов семантического поиска
Ограничения
Для установки нужны Docker с Compose и ключи двух провайдеров: GOOGLE_API_KEY для Gemini и JINA_API_KEY для эмбеддингов. Установщик ./atlas позволяет выбрать и других провайдеров, включая локальную Ollama.
- Токены Slack, Discord и Teams настраиваются в веб-панели и хранятся в MongoDB в зашифрованном виде.
- MCP-ключи (BEEVER_MCP_API_KEYS) должны отличаться от ключей API и бота, иначе сервер не стартует. Ротация ключа требует перезапуска.
- Значения по умолчанию в .env.example рассчитаны на локальную проверку: перед запуском для команды замените ключи и включите `BEEVER_ENV=production`.
- Сервер /mcp по умолчанию выключен, его включает BEEVER_MCP_ENABLED=true.
Как отключить. Уберите запись beever-atlas из настроек MCP клиента и выключите BEEVER_MCP_ENABLED. Стек останавливает команда `docker compose down`, а `docker compose down -v` дополнительно удаляет все проиндексированные данные.
Частые вопросы
Как подключить Beever Atlas к Claude Code?
Включите BEEVER_MCP_ENABLED=true, задайте BEEVER_MCP_API_KEYS и добавьте в .mcp.json сервер с url вида https://atlas.example.com/mcp, transport streamable-http и заголовком Authorization: Bearer с вашим ключом.
Чем отличается stdio-режим от /mcp?
Команда python -m beever_atlas.api.mcp_server (или `beever-atlas-mcp`) запускает тот же каталог инструментов по stdio без HTTP и без хранилищ. Каталог отвечает сразу, а вызовы, читающие знания, без баз вернут структурированную ошибку.
Какие данные Atlas берет из чатов?
Сообщения синхронизированных каналов: из них он строит факты, темы, сущности и связи. Какие каналы синхронизировать, решает пользователь, а ответы MCP фильтруются по доступу ключа к подключениям.
Что нужно, чтобы запустить Atlas локально?
Docker с Compose и два ключа: GOOGLE_API_KEY и JINA_API_KEY. Команда `make demo` поднимает стек с готовым демо-корпусом без ключей для загрузки, а вопросы через /api/ask требуют ключ Gemini.
Сколько инструментов у MCP-сервера?
Двадцать восемь: три для обзора, семнадцать для поиска и чтения, три для графа, один для сессий и три для долгих операций. Рекомендуемый порядок: whoami, list_connections, list_channels, затем остальные.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер ATLAS хранит проекты, задачи и знания агента в графовой базе Neo4j: зависимости, поиск и план глубокого исследования
Официальный MCP сервер Anytype: агент ищет, создает и меняет объекты, списки и типы в вашей базе знаний
MCP WEEEK с базой знаний
weeek-mcp
MCP-сервер для WEEEK: задачи через публичный API и полноценный CRUD базы знаний через внутренний API с сохраненной сессией браузера
Notion MCP (awkoy)
Notion MCP Server (awkoy)
Notion MCP на токене: агент ищет страницы, ведет базы, правит блоки и комментарии через три инструмента и 47 операций, без ручного входа
Официальный облачный MCP-сервер Atlassian для Jira, Confluence, Jira Service Management, Bitbucket, Compass и Loom со скиллами
MCP-сервер для Slack: история каналов, треды, личные сообщения, поиск и непрочитанное, запись выключена по умолчанию
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Beever Atlas (эта запись) | да | API-ключ | 451 | |
| LLM Wiki | нет | 1 473 | плагин собирает вики из заметок и источников, которые вы импортируете сами, без чатов | |
| Deepwiki MCP | нет | не нужна | 1 386 | забирает готовые страницы deepwiki.com о публичных репозиториях, а не вашу переписку |
Коротко о README
Страница рассказывает, как Atlas превращает чаты в вики: шесть коротких демо (подключение платформ, синхронизация, память, вики, вопросы, MCP), схема с двумя хранилищами памяти и объяснение подхода «сначала вики, потом поиск». Дальше три способа установки (установщик ./atlas, ручной Docker, локальная разработка), список обязательных ключей и таблица шагов перед выходом в продакшен. Отдельный раздел посвящен MCP-серверу для внешних агентов со ссылкой на docs/mcp-server.md. Лицензия Apache 2.0.