Phloem MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Phloem
Phloem is an enterprise-grade, self-hosted knowledge base platform built on RAGFlow. It wraps the engine with a typed Node.js API gateway and MCP server for seamless Agent integration.
Phloem (韧皮部) — the vascular tissue that transports nutrients through a plant. Knowledge should flow the same way.
Why Phloem
Self-hosted — your documents, your infrastructure, your control. No data leaves your environment.
Agent-ready — expose your knowledge base via REST API or MCP server, so AI agents get grounded, retrieval-augmented answers.
Typed end-to-end — one OpenAPI contract drives gateway routes, client SDK, and mock layers. Fewer integration surprises.
Swappable backend — an adapter layer isolates RAGFlow; swap or upgrade the engine without touching business code.
Extensible — a registry of extension points (middleware, routes, MCP tools, web modules) designed for plugin-style customization without forking.
Related MCP server: Phloem MCP Server
Architecture
┌────────────┐ REST ┌─────────────┐ ┌──────────────┐
│ Web UI │──────────▶│ Gateway │──adapter──▶│ RAGFlow │
│ (Next.js) │ │ (NestJS) │ │ (submodule) │
└────────────┘ └──────┬──────┘ └──────────────┘
│
┌──────┴──────┐
│ MCP Server │ ◀── Claude Desktop, Cursor, custom agents
└─────────────┘Packages
Package | Description |
Types, Zod schemas, API contracts | |
NestJS (Fastify) API gateway with adapter layer | |
MCP server exposing knowledge tools | |
Next.js 15 App Router console, static export | |
| Shared ESLint flat config |
Getting Started
Prerequisites
Node.js ≥ 22
pnpm ≥ 9
Docker (for RAGFlow backend)
Install
git clone --recurse-submodules https://github.com/phytul/phloem.git
cd phloem
pnpm install
cp deploy/docker/.env.example deploy/docker/.envRun (dev)
# Gateway
pnpm --filter @phloem/gateway dev
# Web console (Next.js dev server, port 5273)
pnpm --filter @phloem/web devRun (with 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 devVerify
curl http://localhost:3000/healthzAPI
The REST contract is the single source of truth: openapi.yaml.
Core resources:
POST /v1/retrieval— hybrid retrieval across datasetsGET/POST /v1/datasets— knowledge base managementPOST /v1/datasets/{id}/documents— document uploadGET /healthz— liveness probe
MCP Tools
Tool | Description |
| Hybrid retrieval across knowledge bases |
| List available knowledge bases |
Development
pnpm run build # build all packages
pnpm run typecheck # strict TS check across the monorepo
pnpm run lint # ESLint + PrettierCommits follow Conventional Commits. Hooks (lint-staged + commitlint) enforce this automatically.
License
Links
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search your knowledge bases from any AI assistant using hybrid RAG.
Cloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.
Private, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.
Governed, auditable knowledge your team curates for its AI assistants, self-hostable
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI agents to query a local knowledge graph built from document collections using hybrid search (BM25 + vector fusion) and entity-relationship extraction. Supports privacy-first, offline operation with tools for semantic search, entity graph exploration, and corpus statistics.3-
- AlicenseNot gradedqualityBmaintenanceExposes knowledge base retrieval tools for AI agents via the Model Context Protocol, enabling hybrid search across datasets and dataset listing.7 npmApache 2.0
- FlicenseAqualityCmaintenanceProvides AI agents with multi-format document indexing, hybrid dense and sparse search with reranking, and relational SQL querying over extracted tables.12-
- AlicenseNot gradedqualityAmaintenanceEnables agents to build self-hosted knowledge bases from document folders and search them via hybrid vector and keyword retrieval, with eight tools for listing, adding, deleting, and reindexing content.114 npm1MIT