Phloem

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

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

Почему Phloem

• Self-hosted — ваши документы, ваша инфраструктура, ваш контроль. Никакие данные не покидают вашу среду.

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

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

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

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

Related MCP server: sage-mcp

Архитектура

┌────────────┐   REST    ┌─────────────┐            ┌──────────────┐
│  Web UI    │──────────▶│   Gateway   │──adapter──▶│   RAGFlow    │
│  (Next.js) │           │  (NestJS)   │            │  (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

Запуск (dev)

# Gateway
pnpm --filter @phloem/gateway dev

# Web console (Next.js dev server, port 5273)
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 — проверка живости (liveness)

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