Modular Rag MCP Server 99f3d7e3

MCPAI代理

提供方 nobitalqs

AI代理 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

一个全模块化的检索增强生成系统,集成MCP协议,支持零代码组件切换和双模式传输。

一句话选型结论

按资料字段整理

Modular Rag MCP Server 99f3d7e3 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

检索增强生成Python本地部署MCP协议模块化设计多模态支持

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python -m venv .venv && source .venv/bin/activate

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Modular Rag MCP Server 99f3d7e3当前 5 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方nobitalqs上游标注的维护方 nobitalqs
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

19.9 KB
来自项目仓库与上游目录的原文,未做删改

Modular RAG MCP Server

English | 中文

A fully modular Retrieval-Augmented Generation system with MCP protocol integration.
Zero-code component switching. 4-layer API resilience. Dual-mode transport (Stdio + HTTP).

一个全模块化 RAG 系统,集成 MCP 协议。
零代码组件切换,四层 API 容错,双模式传输(Stdio + HTTP)。


📖 Overview

A complete RAG pipeline — document ingestion, hybrid search, reranking, multimodal support — exposed as an MCP server. Connect it to GitHub Copilot, Claude Desktop, or any MCP-compatible AI assistant.

Key Features

  • Hybrid Retrieval — BM25 + Dense Embedding + RRF Fusion + Cross-Encoder / LLM Reranking
  • 13 Pluggable Component Families — LLM, Embedding, VectorStore, Reranker, Splitter, Evaluator, Cache, RateLimiter, QueryRewriter, QueryRouter, Memory, CircuitBreaker, Vision LLM — all swappable via settings.yaml
  • 4-Layer Resilience — Rate Limiter → Retry with Backoff → Circuit Breaker → Provider Failover (OpenAI → DeepSeek)
  • Dual Transport — Stdio (local, zero-config) + Streamable HTTP (remote, Docker, multi-user)
  • 5 MCP Tools — query_knowledge_hub, list_collections, get_document_summary, delete_document, ingest_document
  • Multimodal — PDF table extraction, formula OCR, Vision LLM image captioning, Base64 image return
  • Full Observability — JSONL tracing across ingestion + query pipelines, 6-page Streamlit dashboard, Ragas evaluation
  • Multi-Representation Indexing — LLM-generated natural language summaries for code chunks bridge the semantic gap between code and natural language queries

🏗 Architecture```mermaid

graph TB
subgraph Clients
C1[GitHub Copilot]
C2[Claude Desktop]
C3[Other MCP Agents]
end

subgraph MCP["MCP Server Layer"]
    direction LR
    T1[Stdio Transport]
    T2[Streamable HTTP]
    PH[Protocol Handler]
    TOOLS["5 Tools"]
end

subgraph Core["Query Engine"]
    QR[Query Rewriter<br/>LLM / HyDE / None]
    QP[Query Processor]
    HS["Hybrid Search"]
    DR[Dense Retriever<br/>Embedding → ChromaDB]
    SR[Sparse Retriever<br/>BM25 Index]
    FU[RRF Fusion]
    RR[Reranker<br/>CrossEncoder / LLM / Cohere]
    RB[Response Builder<br/>+ Multimodal Assembler]
end

subgraph Ingestion["Ingestion Pipeline"]
    direction LR
    L[Loader<br/>PDF / MD / Code]
    S[Splitter]
    TR[Transform<br/>Refiner + Enricher<br/>+ Captioner + RTG]
    E[Embedding<br/>Dense + Sparse]
    U[Upsert<br/>ChromaDB + BM25]
end

subgraph Libs["Pluggable Libs Layer"]
    direction LR
    LLM["LLM ×4"]
    EMB["Embedding ×3"]
    VS["VectorStore"]
    CACHE["Cache"]
    MEM["Memory"]
    CB["Circuit Breaker<br/>+ Provider Chain"]
end

subgraph Observe["Observability"]
    TRACE[JSONL Tracing]
    DASH[Streamlit Dashboard<br/>6 Pages]
    EVAL[Ragas Evaluation]
end

C1 & C2 & C3 --> MCP
T1 & T2 --> PH --> TOOLS
TOOLS --> Core
Core --> Libs
Ingestion --> Libs
Core & Ingestion --> Observe
QR --> QP --> HS
HS --> DR & SR
DR & SR --> FU --> RR --> RB
L --> S --> TR --> E --> U

### Design Patterns

| Pattern | Usage |
|:--------|:------|
| **Registry + Factory** | All component families — runtime provider registration |
| **Null Object** | NoneReranker, NoneEvaluator, NoneRewriter — no-op fallbacks |
| **Config-Driven** | `settings.yaml` → frozen dataclass → Factory.create_from_settings() |
| **Dual Storage** | ChromaDB (dense vectors) + independent BM25 index (sparse) |
| **4-Layer Resilience** | Rate Limiter → Retry → Circuit Breaker → Provider Failover |
| **Multi-Representation** | Code chunks: LLM summary for dense, raw code for BM25 |

### Resilience Stack

All LLM and Embedding API calls are protected by four composable layers:```
ProviderChain (Layer 4 — Failover)
  └── CircuitBreaker (Layer 3 — Fast-fail after N failures)
        └── RateLimitedLLM (Layer 1 — Token bucket RPM control)
              └── @retry_with_backoff (Layer 2 — Exponential retry on 429/500/502/503)
                    └── HTTP API Call

🚀 Quick Start

Prerequisites

  • Python 3.10+
  • LLM + Embedding provider: cloud API key (OpenAI / Azure / DeepSeek) or local Ollama

Setup```bash

git clone https://github.com/nobitalqs/MODULAR-RAG-MCP-SERVER.git
cd MODULAR-RAG-MCP-SERVER
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
cp config/settings.yaml.example config/settings.yaml # edit for your provider


### Run```bash
# Ingest documents
python scripts/ingest.py --path /path/to/doc.pdf --collection my_kb

# MCP Server — Stdio (for Copilot / Claude Desktop)
python main.py

# MCP Server — HTTP (for remote / Docker deployment)
python main.py --transport http --host 0.0.0.0 --port 8000

# Dashboard
python scripts/start_dashboard.py    # → http://localhost:8501

Connect to MCP Host

GitHub Copilot / VS Code

Add to .vscode/mcp.json:```json
{
"mcpServers": {
"modular-rag": {
"command": "python",
"args": ["main.py"],
"cwd": "/path/to/MODULAR-RAG-MCP-SERVER"
}
}
}


Claude Desktop / Claude Code```json
{
  "mcpServers": {
    "modular-rag": {
      "command": "python",
      "args": ["main.py"],
      "cwd": "/path/to/MODULAR-RAG-MCP-SERVER"
    }
  }
}

HTTP mode (remote)

Start server: python main.py --transport http --host 0.0.0.0 --port 8000

Connect via MCP Streamable HTTP client to http://:8000/mcp

📊 Evaluation

Ragas Evaluation Framework

The project integrates Ragas for automated RAG quality assessment using LLM-as-Judge:

Metric What It Measures
Faithfulness Is the answer grounded in the retrieved context? (anti-hallucination)
Answer Relevancy Does the answer actually address the question?
Context Precision Are the retrieved chunks relevant and well-ranked?

Benchmark Results

Evaluated on a golden test set of 16 queries across 4 categories (3 documents, 440 chunks):

Metric Score What It Means
Faithfulness 0.82 Answers are well-grounded in retrieved context
Context Precision 0.74 Retrieved chunks are relevant and well-ranked
Answer Relevancy 0.61 Answers address the question (room for improvement)

Run your own evaluation:```bash
python scripts/evaluate.py --collection golden --top-k 5


### Test Suite

| Type | Count |
|:-----|------:|
| Unit | 1798 |
| Integration | 70 |
| **Total** | **1868** |

## 🔌 Pluggable Components

| Component | Providers | Config Key |
|:----------|:----------|:-----------|
| LLM | `openai`, `azure`, `ollama`, `deepseek` | `llm.provider` |
| Embedding | `openai`, `azure`, `ollama` | `embedding.provider` |
| Vision LLM | `openai`, `azure` | `vision_llm.provider` |
| Reranker | `cross_encoder`, `llm`, `cohere`, `none` | `rerank.provider` |
| VectorStore | `chroma` | `vector_store.provider` |
| Evaluator | `ragas`, `custom` | `evaluation.provider` |
| Cache | `memory`, `redis` | `cache.provider` |
| Rate Limiter | `token_bucket`, `null` | `rate_limit.provider` |
| Query Rewriter | `llm`, `hyde`, `none` | `query_rewriting.provider` |
| Memory | `memory`, `redis` | `memory.provider` |

> **Adding a new provider:** inherit the base class, implement the interface, register with the factory. Zero modification to existing code.

## 📺 Dashboard

6-page Streamlit management platform:

| Page | Capabilities |
|:-----|:-------------|
| **Overview** | Component config, collection stats, system health |
| **Data Browser** | Browse chunks, metadata, image preview |
| **Ingestion Manager** | Upload, ingest, delete documents with progress tracking |
| **Ingestion Traces** | Stage-by-stage waterfall: load → split → transform → embed → upsert |
| **Query Traces** | Pipeline trace: rewrite → dense/sparse → fusion → rerank |
| **Evaluation Panel** | Run evaluations, view metrics, historical trends |

## 🗺 Roadmap

### Multi-User & Distributed

| Priority | Item | Description |
|:--------:|:-----|:------------|
| 1 | Auth middleware | API Key / OAuth2 on HTTP transport |
| 2 | Multi-tenant isolation | Collection-level tenant separation |
| 3 | Redis state externalization | Cache, Memory, RateLimiter → Redis (code ready, config switch) |
| 4 | BM25 shared storage | Pickle → Redis / Elasticsearch |
| 5 | Distributed vector store | ChromaDB → Milvus / Qdrant |
| 6 | Docker containerization | Dockerfile + docker-compose |

### Advanced RAG

| Item | Description |
|:-----|:------------|
| Agentic RAG | Atomic tools (list_directory, verify_fact) for multi-step agent reasoning |
| Hierarchical Retrieval | Document-level summary → chunk-level search for large corpora |
| Multi-representation expansion | Extend LLM summaries from code to tables and formulas |
| Domain-specific embedding | Different embedding models per doc_type |

## 📂 Project Structure```
src/
├── core/              # Settings, types, query engine, response builder, tracing
├── libs/              # 13 pluggable component families (Factory + Base + Providers)
│   ├── llm/           # 4 LLM + 2 Vision LLM providers
│   ├── embedding/     # 3 providers + EmbeddingChain failover
│   ├── reranker/      # CrossEncoder / LLM / Cohere / None
│   ├── resilience/    # RetryWithBackoff, RateLimitedLLM
│   ├── circuit_breaker/  # CircuitBreaker, ProviderChain, EmbeddingChain
│   └── ...            # cache, memory, query_rewriter, query_router, etc.
├── ingestion/         # 6-stage pipeline: load → split → transform → embed → upsert
├── mcp_server/        # Protocol handler + 5 MCP tools
└── observability/     # Logger, tracing, dashboard (6 pages), evaluation (Ragas)

❓ FAQ

Can I run fully offline?

Yes. Install Ollama, set all providers to ollama, and run with zero API costs:```bash
ollama pull qwen2.5:3b && ollama pull nomic-embed-text


ChromaDB dimension mismatch?

Happens when switching embedding providers (e.g., OpenAI 1536-dim → Ollama 768-dim). Delete the old collection and re-ingest.

How to add a new LLM provider?

1. Inherit `BaseLLM`, implement `chat()`
2. Register: `factory.register_provider("my_provider", MyLLM)`
3. Set `llm.provider: "my_provider"` in settings.yaml

## 📄 License

MIT

---

## 📖 项目简介

一个完整的 RAG 流水线系统 — 文档摄取、混合检索、精排重排、多模态支持 — 通过 MCP 协议 对外暴露,可直接对接 GitHub Copilot、Claude Desktop 等 AI 助手。

### 核心特性

- **混合检索** — BM25 稀疏 + 稠密向量检索,RRF 融合,Cross-Encoder / LLM 精排
- **13 大可插拔组件族** — 全部通过 `settings.yaml` 零代码切换
- **四层 API 容错** — 限流 → 指数退避重试 → 熔断器 → Provider 自动降级(OpenAI → DeepSeek)
- **双模式传输** — Stdio(本地零配置)+ Streamable HTTP(远程部署/Docker/多用户)
- **5 个 MCP 工具** — 知识检索、集合列表、文档摘要、文档删除、远程摄入
- **多模态** — PDF 表格提取、公式 OCR、Vision LLM 图片描述、Base64 图片返回
- **全链路可观测** — JSONL 追踪 + 6 页 Streamlit 仪表盘 + Ragas 评估
- **多表示索引** — 代码块自动生成自然语言摘要用于语义检索,原始代码用于关键词检索

## 🏗 系统架构```mermaid
graph TB
    subgraph 客户端
        C1[GitHub Copilot]
        C2[Claude Desktop]
        C3[其他 MCP Agent]
    end

    subgraph MCP["MCP Server 层"]
        direction LR
        T1[Stdio Transport]
        T2[Streamable HTTP]
        PH[协议处理器]
        TOOLS["5 个工具"]
    end

    subgraph Core["查询引擎"]
        QR[查询改写<br/>LLM / HyDE / None]
        QP[查询处理器]
        HS["混合检索"]
        DR[稠密检索<br/>Embedding → ChromaDB]
        SR[稀疏检索<br/>BM25 倒排索引]
        FU[RRF 融合]
        RR[精排重排<br/>CrossEncoder / LLM / Cohere]
        RB[响应构建<br/>+ 多模态组装]
    end

    subgraph Ingestion["摄取管线"]
        direction LR
        L[文档加载<br/>PDF / MD / Code]
        S[智能切分]
        TR[增强处理<br/>去噪 + 元数据<br/>+ 图片描述 + 多表示]
        E[双路编码<br/>Dense + Sparse]
        U[存储写入<br/>ChromaDB + BM25]
    end

    subgraph Libs["可插拔组件层"]
        direction LR
        LLM["LLM ×4"]
        EMB["Embedding ×3"]
        VS["向量库"]
        CACHE["缓存"]
        MEM["会话记忆"]
        CB["熔断器<br/>+ Provider 级联"]
    end

    subgraph Observe["可观测性"]
        TRACE[JSONL 链路追踪]
        DASH[Streamlit 仪表盘<br/>6 个页面]
        EVAL[Ragas 评估]
    end

    C1 & C2 & C3 --> MCP
    T1 & T2 --> PH --> TOOLS
    TOOLS --> Core
    Core --> Libs
    Ingestion --> Libs
    Core & Ingestion --> Observe
    QR --> QP --> HS
    HS --> DR & SR
    DR & SR --> FU --> RR --> RB
    L --> S --> TR --> E --> U

四层容错体系

所有 LLM / Embedding API 调用均受四层保护:```
ProviderChain(Layer 4 — Provider 降级:OpenAI → DeepSeek)
└── CircuitBreaker(Layer 3 — 连续失败后快速熔断)
└── RateLimitedLLM(Layer 1 — 令牌桶限速)
└── @retry_with_backoff(Layer 2 — 429/500/502/503 指数退避重试)
└── HTTP API 调用


### 设计模式

| 模式 | 应用 |
|:-----|:-----|
| **Registry + Factory** | 全部组件族 — 运行时注册,零工厂修改 |
| **Null Object** | NoneReranker / NoneEvaluator / NoneRewriter — 禁用时的无操作回退 |
| **配置驱动** | `settings.yaml` → frozen dataclass → Factory.create_from_settings() |
| **双存储** | ChromaDB(稠密向量)+ 独立 BM25 索引(稀疏关键词) |
| **多表示索引** | 代码块:LLM 摘要用于 Dense,原始代码用于 BM25 |

## 🚀 快速开始

### 环境要求

- Python 3.10+
- LLM + Embedding 后端:云 API(OpenAI / Azure / DeepSeek)或本地 Ollama

### 安装```bash
git clone https://github.com/nobitalqs/MODULAR-RAG-MCP-SERVER.git
cd MODULAR-RAG-MCP-SERVER
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
cp config/settings.yaml.example config/settings.yaml   # 按需修改

运行```bash

摄取文档

python scripts/ingest.py --path /path/to/doc.pdf --collection my_kb

启动 MCP 服务器

python main.py # Stdio(默认,本地开发)
python main.py --transport http --port 8000 # HTTP(远程/Docker)

启动仪表盘

python scripts/start_dashboard.py # → http://localhost:8501


### 对接 MCP 客户端

GitHub Copilot / VS Code

添加到 `.vscode/mcp.json`:```json
{
  "mcpServers": {
    "modular-rag": {
      "command": "python",
      "args": ["main.py"],
      "cwd": "/path/to/MODULAR-RAG-MCP-SERVER"
    }
  }
}

Claude Desktop / Claude Code```json
{
"mcpServers": {
"modular-rag": {
"command": "python",
"args": ["main.py"],
"cwd": "/path/to/MODULAR-RAG-MCP-SERVER"
}
}
}


HTTP 模式(远程部署)

启动服务:`python main.py --transport http --host 0.0.0.0 --port 8000`

客户端通过 MCP Streamable HTTP 连接 `http://:8000/mcp`

## 📊 评估体系

集成 Ragas 框架,基于 LLM-as-Judge 进行自动化 RAG 质量评估:

| 指标 | 评估内容 |
|:-----|:---------|
| **Faithfulness** | 答案是否基于检索到的上下文?(反幻觉) |
| **Answer Relevancy** | 答案是否真正回答了问题? |
| **Context Precision** | 检索到的文档是否相关且排序合理? |

### 评估基线

基于 **16 条查询、4 个类别** 的黄金测试集(3 份文档,440 chunks):

| 指标 | 分数 | 含义 |
|:-----|:----:|:-----|
| **Faithfulness** | 0.82 | 答案忠实于检索到的上下文 |
| **Context Precision** | 0.74 | 检索到的文档相关且排序合理 |
| **Answer Relevancy** | 0.61 | 答案与问题的相关性(有提升空间) |

运行评估:```bash
python scripts/evaluate.py --collection golden --top-k 5

测试覆盖

类型 数量
单元测试 1798
集成测试 70
合计 1868

🔌 可插拔组件

组件 可选后端 配置项
LLM openai, azure, ollama, deepseek llm.provider
Embedding openai, azure, ollama embedding.provider
Vision LLM openai, azure vision_llm.provider
Reranker cross_encoder, llm, cohere, none rerank.provider
评估器 ragas, custom evaluation.provider
缓存 memory, redis cache.provider
限流器 token_bucket, null rate_limit.provider
查询改写 llm, hyde, none query_rewriting.provider
会话记忆 memory, redis memory.provider

> 新增后端 = 继承基类 + 实现接口 + 注册到 Factory,不改现有代码。

📺 仪表盘

6 页 Streamlit 可视化管理平台:

页面 功能
系统总览 组件配置、集合统计、系统健康
数据浏览器 Chunk 内容、元数据、图片预览
摄取管理 上传文档、触发摄取、删除文档,实时进度
摄取追踪 阶段耗时瀑布图:load → split → transform → embed → upsert
查询追踪 管线追踪:rewrite → dense/sparse → fusion → rerank
评估面板 运行 Ragas 评估、查看指标、历史趋势

🗺 扩展方向

多用户与分布式

优先级 项目 说明
1 认证中间件 HTTP Transport 上加 API Key / OAuth2
2 多租户隔离 Collection 级别按 tenant_id 隔离
3 Redis 状态外置 缓存、记忆、限流 → Redis(代码已就绪,仅需改配置)
4 BM25 共享存储 Pickle → Redis / Elasticsearch
5 分布式向量库 ChromaDB → Milvus / Qdrant
6 Docker 容器化 Dockerfile + docker-compose

高级 RAG

项目 说明
Agentic RAG 原子化工具(list_directory, verify_fact),支持多步 Agent 推理
分层检索 文档级摘要 → chunk 级精搜,适用于大规模语料
多表示扩展 LLM 摘要从代码扩展到表格、公式
领域专用 Embedding 不同 doc_type 使用不同 Embedding 模型

📂 项目结构```

src/
├── core/ # 配置、类型、查询引擎、响应构建、链路追踪
├── libs/ # 13 大可插拔组件族(Factory + Base + Providers)
│ ├── llm/ # 4 个 LLM + 2 个 Vision LLM Provider
│ ├── embedding/ # 3 个 Provider + EmbeddingChain 容错
│ ├── reranker/ # CrossEncoder / LLM / Cohere / None
│ ├── resilience/ # RetryWithBackoff, RateLimitedLLM
│ ├── circuit_breaker/ # 熔断器、ProviderChain、EmbeddingChain
│ └── ... # cache, memory, query_rewriter, query_router 等
├── ingestion/ # 6 阶段管线:load → split → transform → embed → upsert
├── mcp_server/ # 协议处理器 + 5 个 MCP 工具
└── observability/ # 日志、追踪、仪表盘(6 页)、评估(Ragas)


## ❓ 常见问题

能完全离线运行吗?

可以。安装 Ollama,将所有 provider 设为 `ollama`,零 API 费用运行:```bash
ollama pull qwen2.5:3b && ollama pull nomic-embed-text

ChromaDB 维度不匹配?

切换 Embedding Provider 时会出现(如 OpenAI 1536 维 → Ollama 768 维)。删除旧 collection 后重新摄取即可。

如何新增 LLM Provider?

  1. 继承 BaseLLM,实现 chat() 方法
  2. 注册:factory.register_provider("my_provider", MyLLM)
  3. 配置:llm.provider: "my_provider"

📄 License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Modular Rag MCP Server 99f3d7e3 怎么安装?

在客户端按下面的安装命令接入:python -m venv .venv && source .venv/bin/activate。装完在客户端配置里引用同一个包或端点。

Modular Rag MCP Server 99f3d7e3 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Modular Rag MCP Server 99f3d7e3 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Modular Rag MCP Server 99f3d7e3 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Modular Rag MCP Server 99f3d7e3 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Modular Rag MCP Server 99f3d7e3 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 检索增强生成、Python、Claude、模块化设计。具体工具清单以官方文档为准。

Modular Rag MCP Server 99f3d7e3 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Modular Rag MCP Server 99f3d7e3 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。