Skip to main content
Glama
deenesjakoruzh
phytul

Phloem MCP Server

by phytul
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Phloem

Phloem — это корпоративная платформа для базы знаний с самостоятельным размещением, построенная на RAGFlow. Она оборачивает движок типизированным API-шлюзом на Node.js и MCP-сервером для бесшовной интеграции с агентами.

Phloem (韧皮部) — сосудистая ткань, которая транспортирует питательные вещества по растению. Знания должны течь так же.

Почему Phloem

  • Самостоятельное размещение — ваши документы, ваша инфраструктура, ваш контроль. Никакие данные не покидают вашу среду.

  • Готовность к агентам — предоставляйте доступ к вашей базе знаний через REST API или MCP-сервер, чтобы AI-агенты получали обоснованные ответы с дополнением извлечения.

  • Типизированный от начала до конца — один контракт OpenAPI управляет маршрутами шлюза, клиентским SDK и слоями имитации. Меньше сюрпризов при интеграции.

  • Сменяемый бэкенд — слой адаптера изолирует RAGFlow; заменяйте или обновляйте движок, не затрагивая бизнес-логику.

  • Расширяемый — реестр точек расширения (промежуточное ПО, маршруты, инструменты MCP, веб-модули), предназначенный для настройки в стиле плагинов без форка.

Related MCP server: Modular RAG MCP Server

Архитектура

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

Пакеты

Пакет

Описание

@phloem/shared

Типы, схемы Zod, контракты API

@phloem/gateway

API-шлюз Fastify со слоем адаптера

@phloem/mcp

MCP-сервер, предоставляющий инструменты для работы со знаниями

@phloem/web

Веб-консоль React (тёмная, минималистичная)

@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 (mock data via MSW)
VITE_API_MODE=mock 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

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