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: Modular RAG MCP Server
Architecture
┌────────────┐ REST ┌─────────────┐ ┌──────────────┐
│ Web UI │──────────▶│ Gateway │──adapter──▶│ RAGFlow │
│ (React) │ │ (Fastify) │ │ (submodule) │
└────────────┘ └──────┬──────┘ └──────────────┘
│
┌──────┴──────┐
│ MCP Server │ ◀── Claude Desktop, Cursor, custom agents
└─────────────┘Packages
Package | Description |
Types, Zod schemas, API contracts | |
Fastify API gateway with adapter layer | |
MCP server exposing knowledge tools | |
React web console (dark, minimal) | |
| 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 (mock mode — no backend needed)
# Gateway
pnpm --filter @phloem/gateway dev
# Web console (mock data via MSW)
VITE_API_MODE=mock 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…
Related MCP Connectors
Cloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.
Search your knowledge bases from any AI assistant using hybrid RAG.
Private, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.
Universal persistent memory and knowledge retrieval layer for AI agents and LLMs.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceHybrid semantic search (dense vector + BM25) over local knowledge bases and codebases, exposed as MCP tools for AI agents to search and list knowledge bases.-
- AlicenseNot gradedqualityDmaintenanceEnables querying private knowledge bases through a modular RAG pipeline with features like hybrid retrieval, reranking, and observability, exposed via the Model Context Protocol.1MIT
- AlicenseNot gradedqualityDmaintenanceExposes RAG-related tools (query_knowledge_hub, list_collections, get_document_summary) via the Model Context Protocol, enabling AI assistants to perform hybrid search, document ingestion, and evaluation on knowledge bases.MIT
- AlicenseNot gradedqualityDmaintenanceA pluggable RAG framework that exposes hybrid search, ingestion, and evaluation tools via the Model Context Protocol, enabling AI assistants like Copilot and Claude to query knowledge bases directly.MIT