Phloem

Phloem — это корпоративная платформа для базы знаний с самостоятельным размещением, построенная на RAGFlow. Она оборачивает движок типизированным API-шлюзом на Node.js и MCP-сервером для бесшовной интеграции с агентами.

Phloem (韧皮部) — сосудистая ткань, которая транспортирует питательные вещества по растению. Знания должны течь так же.

Почему Phloem

• Самостоятельное размещение — ваши документы, ваша инфраструктура, ваш контроль. Никакие данные не покидают вашу среду.

• Готовность к агентам — предоставляйте доступ к вашей базе знаний через REST API или MCP-сервер, чтобы AI-агенты получали обоснованные ответы с дополнением извлечения.

• Типизированный от начала до конца — один контракт OpenAPI управляет маршрутами шлюза, клиентским SDK и слоями имитации. Меньше сюрпризов при интеграции.

• Сменяемый бэкенд — слой адаптера изолирует RAGFlow; заменяйте или обновляйте движок, не затрагивая бизнес-логику.

• Расширяемый — реестр точек расширения (промежуточное ПО, маршруты, инструменты MCP, веб-модули), предназначенный для настройки в стиле плагинов без форка.

Related MCP server: Modular RAG MCP Server

Архитектура

┌────────────┐   REST    ┌─────────────┐            ┌──────────────┐
│  Web UI    │──────────▶│   Gateway   │──adapter──▶│   RAGFlow    │
│  (React)   │           │  (Fastify)  │            │  (submodule) │
└────────────┘           └──────┬──────┘            └──────────────┘
                                │
                         ┌──────┴──────┐
                         │ MCP Server  │  ◀── Claude Desktop, Cursor, custom agents
                         └─────────────┘

Пакеты

Начало работы

Предварительные требования

• Node.js ≥ 22

• pnpm ≥ 9

• Docker (для бэкенда RAGFlow)

Установка

git clone --recurse-submodules https://github.com/phytul/phloem.git
cd phloem
pnpm install
cp deploy/docker/.env.example deploy/docker/.env

Запуск (режим имитации — бэкенд не требуется)

# Gateway
pnpm --filter @phloem/gateway dev

# Web console (mock data via MSW)
VITE_API_MODE=mock pnpm --filter @phloem/web dev

Запуск (с RAGFlow)

# Build and start RAGFlow (Lite profile, Infinity engine)
docker compose -f deploy/docker/docker-compose.yml -f deploy/docker/docker-compose.lite.yml up -d

pnpm --filter @phloem/gateway dev
pnpm --filter @phloem/web dev

Проверка

curl http://localhost:3000/healthz

API

REST-контракт является единственным источником истины: openapi.yaml.

Основные ресурсы:

• POST /v1/retrieval — гибридный поиск по наборам данных

• GET/POST /v1/datasets — управление базами знаний

• POST /v1/datasets/{id}/documents — загрузка документов

• GET /healthz — проверка работоспособности

Инструменты MCP

Разработка

pnpm run build        # build all packages
pnpm run typecheck    # strict TS check across the monorepo
pnpm run lint         # ESLint + Prettier

Коммиты следуют Conventional Commits. Хуки (lint-staged + commitlint) автоматически обеспечивают это.

Лицензия

Apache-2.0

Ссылки

• RAGFlow — базовый движок

• MCP — Model Context Protocol