Searchless Ngx

MCP搜索检索

提供方 hensing

搜索检索 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

Searchless-ngx 是一个基于 Model Context Protocol (MCP) 和 Agentic RAG 的智能文档检索服务器,可将 Paperless-ngx 实例从静态关键字存档转换为智能对话代理,允许现代 LLM 原生理解、搜索、过滤和推理文档内容。

一句话选型结论

按资料字段整理

Searchless Ngx 属于搜索检索类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

智能检索Python本地部署文档管理LLM集成语义搜索RAG

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run pytest

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Searchless Ngx当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

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

详细介绍

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

🪄 无搜索ngx

> 停止搜索您的文档。开始问他们。 无纸化ngx的代理RAG MCP服务器。

少搜索。更多发现。 无搜索ngx将您的无纸ngx实例从基于关键字的静态存档转换为智能的会话代理。通过利用模型上下文协议(MCP)和代理RAG,它允许现代LLM原生地理解、搜索、过滤和推理您的文档。

🤔 关于名字

如果 无纸化 把你从纸质纸的负担中解放出来, 无搜索 将您从手动搜索的负担中解放出来。

  • 无服务器 意味着你不管理服务器。
  • 无密码 意味着你不输入密码。
  • 无搜索 意味着您不再点击过滤器或浏览20页的PDF。你只要问你的助手一个问题,它就会帮你完成繁重的工作。这 -ngx 向使这一切成为可能的不可思议的Paperless ngx项目致敬。

(注:在引擎盖下,技术服务被命名为 paperless-mcp-server 为AI提供最佳的上下文基础)。

> [!重要]
> 此项目假设您的文档已正确解析(OCR),并在Paperless ngx中分配了高质量的标签。无搜索ngx是一个检索和推理层,而不是一个组织工具。如果您的库需要更好的元数据或自动标记,请查看 无纸化GPT.

✨ 主要特点

  • 代理式检索增强生成:为您的法学硕士配备查询、筛选和汇总个人文档的工具。
  • 混合搜索策略:
  • 精确元数据API:利用Paperless ngx强大的过滤功能(标签、通讯员、日期)进行精确检索。
  • 语义向量搜索:使用ChromaDB和Gemini嵌入来查找基于以下内容的文档 意义 和 上下文 (例如,“软件订阅”、“食品收据”)。
  • 针对开放式WebUI进行了优化:
  • 严格的JSON模式:零 anyOf 或 null 确保与实验性MCP解析器100%兼容。
  • 交互式卡片:搜索结果以漂亮的Markdown卡片形式呈现,带有可点击的标题和元数据。
  • 只读:零破坏性行动。它使用现有的OCR文本,从不下载二进制PDF。
  • 智能同步:启动同步使用水印在几秒钟内仅从Paperless获取新的/更改的文档。定期后台同步(默认值:每15分钟一次,可配置)使索引保持最新。Webhook支持实时摄取单个文档。通过手动完全同步 POST /sync/all.
  • 搜索弹性:主动回退策略可确保LLM即使在初始过滤器限制过大的情况下也能找到文档。

🏗️ 建筑```mermaid

graph TD
User([User]) -->|Chat| OWUI(Open WebUI)
OWUI -->|MCP Streamable HTTP| MCP(FastAPI MCP Server)
MCP -->|Gemini Embeddings| Chroma[(ChromaDB)]
MCP -->|"Read-Only API (metadata, content, sync)"| Paperless(Paperless-ngx)
MCP -->|Paginated Cache| Cache[(In-Memory Metadata)]

External([Paperless Workflow / External]) -->|POST /webhook/sync| MCP
Timer([Periodic Sync\nevery 15 min]) -->|bulk_sync_documents| MCP


## 🚀 设置和安装

### 1.先决条件

- Docker&Docker编写
- 无纸化ngx实例
- Google Gemini API密钥(用于嵌入和/或LLM)

### 2.环境配置

复制 `.env.example` 到 `.env` 并配置:```bash
cp .env.example .env
变量 描述
PAPERLESS_URL 您的无纸ngx基本URL
PAPERLESS_TOKEN 来自无纸设置的API令牌。
GEMINI_API_KEY 用于嵌入的Google GenAI密钥。
PAPERLESS_PUBLIC_URL (可选)聊天中用于可点击链接的URL。默认为 PAPERLESS_URL.
LOG_LEVEL (可选)日志详细程度: INFO (默认)或 DEBUG.
MAX_CHUNKS_PER_DOC (可选)限制每个文档的段数(默认值:100≈25页)。
BULK_SYNC_LIMIT (可选)将初始摄入限制在X个最新文档。
SYNC_INTERVAL_MINUTES (可选)周期性后台同步间隔(分钟)(默认值:15)。吃起来 0 禁用。

3.Docker编写

启动代理并打开WebUI:```bash
docker compose up -d


### 4.连接到Open WebUI

1. 打开 `http://localhost:8080`.
1. 首选 **设置>连接>MCP服务器**.
1. **首选方法**:单击导入按钮并选择 `scripts/webui-connection.json`.
1. **手动方法**:添加类型为的新服务器 `MCP Streamable HTTP` 和URL `http://mcp-server:8001/mcp`.

有关Open WebUI的详细说明,请参阅 WEBUI_SETUP.md.

## 💡 使用示例

### 列出文档

- *“列出亚马逊的最后5个文档。”* (使用精确的元数据搜索)
- *“显示我最近的发票。”* (使用空查询按日期提取)

### 概念搜索(语义)

- *“查找我拥有的所有软件订阅。”* (即使标题中没有“订阅”,也会找到“Netflix”、“Adobe”、“Microsoft”)
- *“我上次去柏林的食物收据在哪里?”* (将位置上下文与文档含义相结合)

### 数据提取

- *“2024年2月,我在出行方面花了多少钱?”* (LLM迭代搜索/火车发票并计算总和)
- *“总结一下我的健身房合同的取消条款。”* (LLM使用 `get_document_details` 阅读完整的OCR文本)

## 🛠️ 开发与测试

### 诊断工具

使用原始协议检查器验证服务器的输出:```bash
docker exec paperless-mcp-server python scripts/test_mcp_raw.py

测试覆盖率

使用以下命令运行测试套件 uv:bash uv run pytest

👤 作者

由开发和维护 Henning Dickten博士 (@伊辛).

⚖️ 许可证

根据GPLv3许可。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Searchless Ngx 怎么安装?

在客户端按下面的安装命令接入:uv run pytest。装完在客户端配置里引用同一个包或端点。

Searchless Ngx 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Searchless Ngx 收费吗?

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

Searchless Ngx 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Searchless Ngx 能提供哪些能力?

资料显示能力标签包括 搜索、Python、文档处理、RAG。具体工具清单以官方文档为准。

Searchless Ngx 需要什么运行环境?

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

Searchless Ngx 是本地还是远程?

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

热门专题

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

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