Skip to main content
Glama
yorikhu
by yorikhu

Phloem

Phloem は、RAGFlow 上に構築されたエンタープライズ向けのセルフホスト型ナレッジベースプラットフォームです。エンジンを型付き Node.js API ゲートウェイと MCP サーバーでラップし、シームレスな Agent 統合を実現します。

Phloem(師部)— 植物内で栄養を運ぶ維管組織。知識も同じように流れるべきです。

Phloem を選ぶ理由

  • セルフホスト — あなたのドキュメント、あなたのインフラ、あなたのコントロール。データが環境外に流出することはありません。

  • Agent 対応 — REST API または MCP サーバー経由でナレッジベースを公開し、AI エージェントが根拠に基づいた検索拡張(RAG)回答を得られるようにします。

  • エンドツーエンドの型付け — 単一の OpenAPI コントラクトがゲートウェイルート、クライアント SDK、モックレイヤーを駆動します。統合時の驚きが少なくなります。

  • 交換可能なバックエンド — アダプターレイヤーが RAGFlow を分離し、ビジネスコードに触れることなくエンジンを交換・アップグレードできます。

  • 拡張可能 — 拡張ポイント(ミドルウェア、ルート、MCP ツール、Web モジュール)のレジストリを備え、フォークなしのプラグイン形式のカスタマイズを可能にします。

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

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • 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
    -
  • 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
  • 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