Skip to main content
Glama
deenesjakoruzh
yorikhu

Phloem MCP Server

by yorikhu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Phloem

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

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

Phloem을 선택하는 이유

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

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

  • 종단 간 타입 지정 — 하나의 OpenAPI 계약이 게이트웨이 라우트, 클라이언트 SDK, 목 계층을 구동합니다. 통합 시 예상치 못한 문제가 줄어듭니다.

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

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

Related MCP server: Qurio MCP Server

아키텍처

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

패키지

패키지

설명

@phloem/shared

타입, Zod 스키마, API 계약

@phloem/gateway

어댑터 계층이 있는 NestJS(Fastify) API 게이트웨이

@phloem/mcp

지식 도구를 노출하는 MCP 서버

@phloem/web

Next.js 15 App Router 콘솔, 정적 내보내기

@phloem/eslint-config

공유 ESLint 플랫 구성

시작하기

사전 요구 사항

  • Node.js ≥ 22

  • pnpm ≥ 9

  • Docker (RAGFlow 백엔드용)

설치

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

실행 (개발)

# Gateway
pnpm --filter @phloem/gateway dev

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

실행 (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

확인

curl http://localhost:3000/healthz

API

REST 계약은 단일 소스입니다: openapi.yaml.

핵심 리소스:

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

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

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

  • GET /healthz — 활성 상태 프로브

MCP 도구

도구

설명

retrieve_knowledge

지식 베이스 전반의 하이브리드 검색

list_datasets

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

개발

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

라이선스

Apache-2.0

링크

  • RAGFlow — 기본 엔진

  • MCP — Model Context Protocol

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GraphRAG Llama Index MCP

    T-NhanNguyen
    F
    license
    A
    quality
    D
    maintenance
    Enables 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
    -

  • Qurio MCP Server

    irahardianto
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding assistants to search and retrieve information from a locally ingested knowledge base using hybrid search, grounded in user-curated documentation.
    17
    MIT

  • Phloem MCP Server

    phytul
    A
    license
    Not graded
    quality
    B
    maintenance
    Exposes knowledge base retrieval tools for AI agents via the Model Context Protocol, enabling hybrid search across datasets and dataset listing.
    0
    Apache 2.0