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エージェントが根拠のある検索拡張回答を得られるようにします。

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

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

  • 拡張可能 — ミドルウェア、ルート、MCPツール、Webモジュールなどの拡張ポイントのレジストリ。フォークせずにプラグイン形式のカスタマイズが可能です。

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 Webコンソール（ダーク、ミニマル）

@phloem/eslint-config

共有ESLintフラット設定

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/.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 — Model Context Protocol

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