Skip to main content
Glama
deenesjakoruzh
phytul

Phloem MCP Server

by phytul
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Phloem

Phloem은 엔터프라이즈급의 자체 호스팅 지식 베이스 플랫폼으로, RAGFlow를 기반으로 구축되었습니다. 엔진을 타입이 지정된 Node.js API 게이트웨이 및 MCP 서버로 감싸 에이전트와의 원활한 통합을 제공합니다.

Phloem (韧皮部) — 식물에서 영양분을 운반하는 관다발 조직입니다. 지식도 같은 방식으로 흘러야 합합니다.

Why Phloem

  • 자체 호스팅 — 귀하의 문서, 귀하의 인프라, 귀하의 통제. 데이터가 환경 밖으로 나가지 않습니다.

  • 에이전트 지원 — REST API 또는 MCP 서버를 통해 지식 베이스를 노출하여 AI 에이전트가 근거 있는 검색 증강 답변을 얻을 수 있습니다.

  • 엔드투엔드 타입 안전 — 하나의 OpenAPI 계약이 게이트웨이 라우트, 클라이언트 SDK 및 모킹 레이어를 구동합니다. 통합 시 예상치 못한 문제가 줄어듭니다..

  • 교체 가능한 백엔드 — 어댑터 레이어가 RAGFlow를 격리합니다; 비즈니스 코드를 건드리지 않고 엔진을 교체하거나 업그레이드할 수 있습니다.

  • 확장 가능 — 미들웨어, 라우트, MCP 도구, 웹 모듈 등의 확장 지점 레지스트리로, 포크 없이 플러그인 스타일의 사용자 정의가 가능합니다.

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

@phloem/shared

타입, Zod 스키마, API 계약

@phloem/gateway

어터 레이어가 포함된 Fastify API 게이트웨이

@phloem/mcp

지식 도구를 노하는 MCP 서버

@phloem/web

React 웹 콘솔 (다크, 미니멀)

@phloem/eslint-config

공유 ESLint 플랫 설정

Getting Started

Prerequisites

  • Node.js ≥ 22

  • pnpm ≥ 9

  • Docker (RAGFlow 백엔드용)

Install

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

Run (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 dev

Run (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 dev

Verify

curl http://localhost:3000/healthz

API

REST 계약이 단일 진실 공급원입니다: openapi.yaml.

핵심 리소스:

  • POST /v1/retrieval — 데이터셋 간 하이브리드 검색

  • GET/POST /v1/datasets — 지식 베이스 관리

  • POST /v1/datasets/{id}/documents — 문서 업로드

  • GET /healthz — 활성 상태 확인

MCP Tools

Tool

Description

retrieve_knowledge

지식 베이스 간 하이브리드 검색

list_datasets

사용 가능한 지식 베이스 목록 표시

Development

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)이 이를 자동으로 적용합니다.

License

Apache-2.0

Links

  • RAGFlow — 기본 엔진

  • MCP — 모델 컨텍스트 프로토콜

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • sage-mcp

    ltaysh0
    F
    license
    Not graded
    quality
    C
    maintenance
    Hybrid semantic search (dense vector + BM25) over local knowledge bases and codebases, exposed as MCP tools for AI agents to search and list knowledge bases.
    -

  • Modular RAG MCP Server

    Nhuajia
    A
    license
    Not graded
    quality
    D
    maintenance
    Exposes 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

  • Modular RAG MCP Server

    sjjjlol
    A
    license
    Not graded
    quality
    D
    maintenance
    A 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