Flexible GraphRAG MCP
MCP-сервер для платформы GraphRAG: загрузка документов из 14 источников, гибридный поиск и ответы ИИ по графу знаний
- 197 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Инструменты загрузки принимают логины и пароли хранилищ вроде Alfresco, S3 и SharePoint прямо в параметрах.
- Без входа пользователя поиск и ответы строятся по всем документам хранилища, включая закрытые.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/flexible-graphrag-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты загрузки принимают логины и пароли хранилищ вроде Alfresco, S3 и SharePoint прямо в параметрах.
- Без входа пользователя поиск и ответы строятся по всем документам хранилища, включая закрытые.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Flexible GraphRAG MCP — MCP-сервер, который подключает Claude Desktop и другие MCP-клиенты к платформе Flexible GraphRAG. Платформа разбирает документы, строит граф знаний и векторный индекс, а сервер отдает агенту ее возможности как инструменты. Инструмент `ingest_documents` загружает файлы из 14 источников: диска, Alfresco, Nuxeo, SharePoint, OneDrive, Box, Google Drive, S3, Google Cloud Storage, Azure Blob, CMIS, веб-страниц, Wikipedia и YouTube. `ingest_text` принимает произвольный текст. `search_documents` ведет гибридный поиск, а `query_documents` отвечает на вопрос по найденным документам. `check_processing_status` показывает ход фоновой загрузки, `get_system_status` и `health_check` проверяют связь с серверной частью. Пользователи могут видеть не все документы. Инструменты `sign_in`, `start_sign_in` и `finish_sign_in` передают учетные данные источника, и тогда поиск и ответы ограничиваются тем, что этому пользователю разрешено читать.
Для кого. Разработчикам корпоративного поиска и RAG на документах из Alfresco, SharePoint или S3, которые хотят задавать вопросы к базе знаний из Claude Desktop.
Подходит, если
- Папку с договорами и отчетами загружают в граф знаний и спрашивают у Claude, какие документы упоминают конкретного подрядчика.
- Сотрудники корпоративного хранилища получают ответы только по тем файлам, которые им разрешено читать.
- Вики-страницы и ролики YouTube по теме собирают в одну базу и ищут по ним без перехода между сайтами.
- Для отладки извлечения запускают сервер в HTTP-режиме и подключают MCP Inspector.
- Загрузку большого набора файлов ускоряют флагом `skip_graph` и оставляют только векторный поиск.
Не подходит, если
- Серверную часть Flexible GraphRAG поднимать не хочется: сам MCP-сервер без нее ничего не делает.
- Нужен поиск по нескольким заметкам в одной папке: тяжелый стек с графовой базой избыточен.
- Нужен источник вне списка из 14: загрузка работает только с перечисленными источниками.
Пример запроса к агенту
Загрузи документы из папки `./sample-docs/` и скажи, какие основные выводы есть в исследовательских статьях.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
FLEXIBLE_GRAPHRAG_TRUSTED_KEYсекрет- Общий случайный ключ: серверная часть доверяет серверу и отвечает без входа пользователя.
MCP_BROWSER_SIGN_IN- Включает инструменты входа через браузер в Microsoft 365, Box, Google и Azure Storage.
Ограничения
Сервер связывается с серверной частью на FastAPI, которую запускают отдельно (по умолчанию `localhost:8000`), и берет ее настройки из `.env`: ключ провайдера LLM, графовую базу вроде Neo4j и другие. Без входа поиск и ответы идут по всем документам хранилища. Чтобы серверная часть доверяла MCP-серверу без входа пользователя, на обеих сторонах задают общий случайный ключ. HTTP-режим и вход через браузер включаются отдельными настройками. Учетные данные источников передаются параметрами инструментов, поэтому не показывайте их в общих чатах.
Как отключить. Уберите запись `flexible-graphrag` из `claude_desktop_config.json` и перезапустите Claude Desktop. Установленный через pipx пакет удаляет `pipx uninstall flexible-graphrag-mcp`. Серверную часть и базы остановите отдельно.
Частые вопросы
Как подключить Flexible GraphRAG MCP к Claude Desktop?
Добавьте в `claude_desktop_config.json` сервер `flexible-graphrag` с командой `uvx` и аргументом `flexible-graphrag-mcp`, затем перезапустите Claude Desktop. Готовые конфиги для Windows и macOS лежат в папке `claude-desktop-configs`.
Что нужно запустить кроме самого MCP-сервера?
Серверную часть FastAPI: `uv run uvicorn main:app --host 0.0.0.0 --port 8000` в папке `flexible-graphrag`. Ей нужен заполненный `.env` с ключом провайдера LLM и подключением к графовой базе.
Как отладить сервер в MCP Inspector?
Запустите `flexible-graphrag-mcp --http --port 3001` и подключитесь к `http://localhost:3001/mcp`. В репозитории есть готовые конфиги для режимов stdio и HTTP.
Как ограничить ответы правами пользователя?
Передайте учетные данные через `sign_in` или включите `MCP_BROWSER_SIGN_IN=true` для входа в браузере. Источники с переданным входом фильтруются по правам, остальные остаются без фильтра.
Можно ли закрыть HTTP-конечную точку?
Да. Задайте `MCP_TRANSPORT_AUTH=true` и `MCP_AUTH_JWKS_URI`, и сервер потребует токен OAuth2, подписанный вашим поставщиком идентификации. Для stdio эта настройка не действует.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыGraphlit MCP Server — база знаний для агента
Graphlit MCP Server
Официальный MCP-сервер Graphlit: агент собирает материалы из Slack, GitHub, почты и сайтов в базу знаний и ищет по ней
Локальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
Граф знаний с MCP-сервером: агент ищет понятия по смыслу, видит, насколько они подтверждены, и находит спорные места в источниках.
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
MCP-сервер InfraNodus строит из текста граф знаний и показывает кластеры тем, пробелы между ними и вопросы для исследования
Самохостинг RAG-приложение с веб-интерфейсом и встроенным MCP-сервером: документы, Qdrant, ответы с источниками.
Коротко о README
README пакета начинается с обзора платформы и версии 0.9.0, затем идет быстрый старт для Windows и macOS с конфигами Claude Desktop. Отдельные разделы объясняют три уровня фильтрации по правам, защиту HTTP-режима токеном и разбор типичных сбоев.