AI LocalBase MCP
Самохостинг RAG-приложение с веб-интерфейсом и встроенным MCP-сервером: документы, Qdrant, ответы с источниками.
- 386 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Через MCP агент читает документы базы, а при расширенных правах ключа загружает файлы и удаляет данные.
- Без `ENABLE_AUTH=true` сервис на сервере остается без входа, и MCP открывать в таком виде нельзя.
Установка
- Работает в
Ручная установка
docker compose up --buildПеред запуском скопируйте `.env.example` в `.env`. Затем включите `ENABLE_MCP=true` и создайте ключ API.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Через MCP агент читает документы базы, а при расширенных правах ключа загружает файлы и удаляет данные.
- Без `ENABLE_AUTH=true` сервис на сервере остается без входа, и MCP открывать в таком виде нельзя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AI LocalBase — самостоятельное приложение для базы знаний с веб-интерфейсом: Go и Gin на бэкенде, React на фронтенде, Qdrant как векторная база. Агент подключается к нему через встроенный MCP-сервер по HTTP и JSON-RPC и получает доступ к документам, поиску и чату. Загружаются TXT, Markdown, PDF с текстом, xlsx и csv: файлы режутся на части, превращаются во вложения и ищутся с переранжированием и отбором без повторов. MCP выключен по умолчанию и включается переменной `ENABLE_MCP=true`. Инструменты делятся на чтение, запись и опасные, а доступ задается ключом API с правами `mcp:*`: `mcp:read`, `mcp:upload`, `mcp:eval` и `mcp:danger` для удаления. Есть инструменты ответа с источниками, проверки качества базы, сравнения режимов поиска и создания оценочных наборов, а импорт больших пакетов идет фоновыми заданиями с отменой.
Для кого. Тем, кто хочет дать агенту доступ к собственной базе документов на своем сервере без облачных RAG-сервисов.
Подходит, если
- Документы команды лежат в PDF, Markdown и таблицах, и агент должен отвечать по ним со ссылкой на источник.
- База знаний живет на вашем сервере, а Cursor или Claude Desktop подключают к ней по MCP.
- Качество поиска проверяют: сравнивают режимы и строят оценочные наборы из своих документов.
- Большой пакет файлов индексируют в фоне и следят за ходом задания.
Не подходит, если
- Развертывание на нескольких серверах: приложение рассчитано на один экземпляр, и вторая копия сломает запись в SQLite.
- Облачное решение без самостоятельной установки: потребуются Docker Compose, Qdrant и модель.
- Открытый доступ без входа: MCP включают только при `ENABLE_AUTH=true`.
Пример запроса к агенту
Найди в базе знаний AI LocalBase пункты договора об оплате и приведи источники.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
ENABLE_MCPобязательная- Включает MCP-сервер, по умолчанию `false`.
ENABLE_AUTHобязательная- Включает вход и ключи API, без него MCP открывать не стоит.
MCP_BASE_PATH- Путь MCP, по умолчанию `/mcp`.
Ограничения
Приложению нужны Docker Compose, Qdrant и модели для чата и вложений: Ollama или любой OpenAI-совместимый API. Рассчитано на один экземпляр: историю чатов в SQLite и задания MCP в памяти нельзя делить между репликами. Размерность `QDRANT_VECTOR_SIZE` должна совпадать с моделью вложений, а при смене модели нужен новый `QDRANT_COLLECTION_PREFIX`. Сервер MCP отдает JSON, не выдает идентификаторы сессий и не поддерживает SSE. README написан на китайском языке.
Как отключить. Верните `ENABLE_MCP=false`, перезапустите бэкенд и отзовите ключ API в настройках приложения. Остановить все службы можно командой `docker compose down`.
Частые вопросы
Как поднять AI LocalBase?
Скопируйте `.env.example` в `.env` и выполните `docker compose up --build`. Интерфейс откроется на `http://localhost:4173`, модели чата и вложений настраиваются на странице настроек.
Как подключить к Cursor или Claude Desktop?
Включите `ENABLE_MCP=true`, создайте ключ API с правами `mcp:*` и укажите `http://127.0.0.1:8080/mcp` как HTTP-сервер MCP. В настройках приложения есть готовые шаблоны для Cherry Studio, Claude Desktop и Cursor.
Какие права выдать ключу?
Для чтения хватит `mcp:read`, для загрузки нужен `mcp:upload`, для оценки `mcp:eval`. Право `mcp:danger` открывает инструменты удаления, его выдают только по необходимости.
Какие файлы можно загрузить?
TXT, Markdown, PDF с текстовым слоем, xlsx и csv.
Можно ли запустить несколько копий?
Нет. Приложение рассчитано на один экземпляр, и `docker compose scale backend=2` не поддерживается.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
Graphlit MCP Server — база знаний для агента
Graphlit MCP Server
Официальный MCP-сервер Graphlit: агент собирает материалы из Slack, GitHub, почты и сайтов в базу знаний и ищет по ней
Локальная база знаний по PDF, сканам и файлам Office: гибридный поиск, права доступа и ответы с ссылкой на страницу
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
Локальный RAG в контейнерах с MCP-сервером: агент ищет по вашим документам, данные остаются на своей машине
MCP-сервер для платформы GraphRAG: загрузка документов из 14 источников, гибридный поиск и ответы ИИ по графу знаний
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AI LocalBase (эта карточка) | нет | API-ключ | 386 | |
| knowledge-rag | нет | не нужна | 301 | локальный MCP-сервер над папкой документов, а AI LocalBase полноценное приложение с веб-интерфейсом, Qdrant и правами ключей |
| Pharos | нет | API-ключ | 241 | локальная база знаний по PDF, сканам и файлам Office, а AI LocalBase добавляет оценку качества поиска и фоновые задания импорта |
Коротко о README
Репозиторий описывает приложение на Docker Compose для личных баз знаний и небольших команд. Подробные команды и переменные лежат в `docs/getting-started.md`, а описание инструментов MCP, прав и примеров вызова в `docs/mcp.md`.