Phloem

Phloem es una plataforma de base de conocimiento autohospedada de nivel empresarial construida sobre RAGFlow. Envuelve el motor con una pasarela API de Node.js tipada y un servidor MCP para una integración fluida con agentes.

Phloem (韧皮部) — el tejido vascular que transporta nutrientes a través de una planta. El conocimiento debería fluir de la misma manera.

Por qué Phloem

• Autohospedado — tus documentos, tu infraestructura, tu control. Ningún dato sale de tu entorno.

• Listo para agentes — expón tu base de conocimiento mediante API REST o servidor MCP, para que los agentes de IA obtengan respuestas fundamentadas y aumentadas por recuperación.

• Tipado de extremo a extremo — un único contrato OpenAPI impulsa las rutas de la pasarela, el SDK de cliente y las capas mock. Menos sorpresas de integración.

• Backend intercambiable — una capa de adaptadores aísla RAGFlow; cambia o actualiza el motor sin tocar el código de negocio.

• Extensible — un registro de puntos de extensión (middleware, rutas, herramientas MCP, módulos web) diseñado para personalización estilo plugin sin hacer fork.

Related MCP server: sage-mcp

Arquitectura

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

Paquetes

Primeros pasos

Requisitos previos

• Node.js ≥ 22

• pnpm ≥ 9

• Docker (para el backend de RAGFlow)

Instalar

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

Ejecutar (dev)

# Gateway
pnpm --filter @phloem/gateway dev

# Web console (Next.js dev server, port 5273)
pnpm --filter @phloem/web dev

Ejecutar (con 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

Verificar

curl http://localhost:3000/healthz

API

El contrato REST es la única fuente de verdad: openapi.yaml.

Recursos principales:

• POST /v1/retrieval — recuperación híbrida entre conjuntos de datos

• GET/POST /v1/datasets — gestión de bases de conocimiento

• POST /v1/datasets/{id}/documents — subida de documentos

• GET /healthz — sonda de actividad

Herramientas MCP

Desarrollo

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

Los commits siguen Conventional Commits. Los hooks (lint-staged + commitlint) lo aplican automáticamente.

Licencia

Apache-2.0

Enlaces

• RAGFlow — el motor subyacente

• MCP — Model Context Protocol