Phloem

Phloem ist eine selbstgehostete Wissensdatenbank-Plattform mit Enterprise-Reife, die auf RAGFlow basiert. Sie umhüllt die Engine mit einem typisierten Node.js-API-Gateway und einem MCP-Server für eine nahtlose Agentenintegration.

Phloem (韧皮部) – das Leitgewebe, das Nährstoffe durch eine Pflanze transportiert. Wissen sollte auf dieselbe Weise fließen.

Warum Phloem

• Selbstgehostet – Ihre Dokumente, Ihre Infrastruktur, Ihre Kontrolle. Keine Daten verlassen Ihre Umgebung.

• Agentenbereit – Machen Sie Ihre Wissensdatenbank über REST-API oder MCP-Server zugänglich, sodass KI-Agenten fundierte, retriever-gestützte Antworten erhalten.

• Durchgehend typisiert – Ein OpenAPI-Vertrag treibt Gateway-Routen, Client-SDK und Mock-Ebenen an. Weniger Überraschungen bei der Integration.

• Austauschbares Backend – Eine Adapterschicht isoliert RAGFlow; tauschen Sie die Engine aus oder aktualisieren Sie sie, ohne Geschäftslogik zu berühren.

• Erweiterbar – Ein Register von Erweiterungspunkten (Middleware, Routen, MCP-Tools, Webmodule), das für Plugin-artige Anpassungen ohne Forking konzipiert ist.

Related MCP server: Modular RAG MCP Server

Architektur

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

Pakete

Erste Schritte

Voraussetzungen

• Node.js ≥ 22

• pnpm ≥ 9

• Docker (für das RAGFlow-Backend)

Installieren

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

Ausführen (Mock-Modus – kein Backend erforderlich)

# Gateway
pnpm --filter @phloem/gateway dev

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

Ausführen (mit 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

Überprüfen

curl http://localhost:3000/healthz

API

Der REST-Vertrag ist die einzige Quelle der Wahrheit: openapi.yaml.

Kernressourcen:

• POST /v1/retrieval – Hybrid Retrieval über Datensätze hinweg

• GET/POST /v1/datasets – Verwaltung von Wissensdatenbanken

• POST /v1/datasets/{id}/documents – Dokumentenupload

• GET /healthz – Lebendigkeitsprüfung

MCP-Tools

Entwicklung

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

Commits folgen Conventional Commits. Hooks (lint-staged + commitlint) setzen dies automatisch durch.

Lizenz

Apache-2.0

Links

• RAGFlow – die zugrundeliegende Engine

• MCP – Model Context Protocol