OpenDocuments MCP
Самостоятельно размещаемая RAG-платформа: ответы с цитатами по GitHub, Notion, Drive и файлам, MCP-режим для Claude Code.
- 123 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент через MCP получает доступ ко всему проиндексированному корпусу документов.
- При облачной модели фрагменты документов уходят провайдеру.
Установка
- Работает в
Ручная установка
npm install -g opendocumentsПосле установки выполните `opendocuments init` и `opendocuments start`; для MCP-режима `opendocuments start --mcp-only`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент через MCP получает доступ ко всему проиндексированному корпусу документов.
- При облачной модели фрагменты документов уходят провайдеру.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenDocuments собирает разбросанные документы в базу знаний с ИИ-поиском на вашей инфраструктуре. Коннекторы забирают GitHub, Notion, Google Drive, Confluence, S3 и GCS, Swagger и OpenAPI, веб-страницы и локальные файлы. Парсеры читают Markdown, PDF, DOCX, XLSX, CSV, код и другие форматы, метаданные ложатся в SQLite, векторы в LanceDB, а ответы приходят с цитатами источников. Команда `opendocuments start --mcp-only` включает режим MCP, и Claude Code, Cursor или Windsurf ищут по корпусу документов прямо при написании кода. Модели подключают локальные через Ollama или облачные: OpenAI, Anthropic, Google и xAI. Есть CLI, веб-интерфейс, HTTP API, SDK, плагины и командный режим с ключами и ролями.
Для кого. Командам, у которых знания лежат в GitHub, Notion, Confluence и на дисках и которые хотят дать агенту поиск по ним без отправки данных в чужое облако.
Подходит, если
- Агенту при написании кода нужны внутренние документы по авторизации и API.
- Онбординг-гайды в DOCX на S3 и спецификации в Notion ищут одним вопросом с цитатами.
- Чувствительные документы остаются внутри: локальная модель через Ollama отвечает без облака.
- Разные отделы работают в одном экземпляре с изоляцией рабочих пространств и журналом аудита.
Не подходит, если
- Нужен поиск по одной папке без развертывания платформы: понадобится более легкий локальный MCP-сервер.
- Модель не настроена: веб-интерфейс блокирует вопросы, пока не готов корпус и модель.
- Документы нельзя отправлять облачным моделям, а локальной модели на машине нет.
Пример запроса к агенту
Найди в наших документах, как обновляется JWT-токен, и покажи источники.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OPENDOCUMENTS_MODEL_PROVIDER- Провайдер модели, например `ollama`.
OPENDOCUMENTS_MODEL_BASE_URL- Адрес сервера модели, например `http://localhost:11434`.
Ограничения
Нужен Node.js 20 или новее. Работе нужна модель: локальная через Ollama или облачная с ключом; при облачной модели фрагменты документов уходят провайдеру. Обычный `start` модель не скачивает. При неготовом корпусе веб-интерфейс блокирует вопросы и показывает шаг исправления. В режиме `--mcp-only` клиент получает доступ ко всему проиндексированному корпусу, поэтому индексируйте только то, что можно показывать агенту. Последний коммит репозитория сделан в июле 2026 года.
Как отключить. Удалите запись `opendocuments` из конфигурации MCP-клиента и выполните `npm uninstall -g opendocuments`. Индекс SQLite и LanceDB в каталоге проекта удалите отдельно.
Частые вопросы
Как подключить к Claude Code?
Добавьте MCP-сервер с `command` равным `opendocuments` и `args` равным `["start", "--mcp-only"]`. После этого агент ищет по проиндексированным документам.
Какие источники поддерживаются?
GitHub, Notion, Google Drive, Confluence, S3 и GCS, Swagger и OpenAPI, веб-страницы, загрузки и локальные файлы. Синхронизацию коннектора запускает `opendocuments connector sync github`.
Можно ли работать полностью локально?
Да. С Ollama локальная модель и эмбеддинги отвечают без облака; помощник `opendocuments init` определяет Ollama и спрашивает, скачивать ли недостающие модели.
Что проверить, если ответов нет?
Запустите `opendocuments doctor`: он проверяет связь с Ollama, наличие моделей и корректность конфигурации.
Как сделать резервную копию?
Команда резервного копирования снимает SQLite и LanceDB, и экземпляр восстанавливается одной командой.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки
OpenWiki создает Markdown-вики по репозиторию, сохраняет основания фактов и дает агенту поиск по документации нескольких проектов.
MCP-сервер связывает агента с учебным холстом, где вопрос к фрагменту документа открывает новый связанный материал.
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
Локальный MCP-сервер позволяет агенту искать и читать вашу библиотеку Zotero, хранилище Obsidian и Apple Notes через ядро на C++
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OpenDocuments (эта карточка) | нет | не нужна | 123 | |
| MCP Local RAG | нет | не нужна | 429 | mcp-local-rag ищет по локальной папке без внешней базы; OpenDocuments добавляет коннекторы GitHub, Notion и Confluence, веб-интерфейс и командный режим |
| knowledge-rag | нет | не нужна | 301 | knowledge-rag превращает папку в базу знаний для Claude Code; OpenDocuments держит корпус из многих внешних источников с ролями и аудитом |
Коротко о README
Платформа проходит стандартный цикл RAG: источник, разбор, нарезка, эмбеддинги, поиск с повторным ранжированием и ответ с цитатами. MCP-режим выводит тот же поиск наружу для агентов, остальное доступно через CLI, веб-интерфейс и HTTP API.