mcp-server-rag

MCP文档知识

提供方 godofwar5946

文档知识 未标注 会话登录 社区 / 第三方 Zed

A RAG service built on Spring AI MCP, supporting batch upload, categorized indexing, and semantic retrieval for documents and Java/C/C++ code, suitable for enterprise knowledge base management, code search, and intelligent Q&A.

一句话选型结论

按资料字段整理

mcp-server-rag 属于文档知识类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Zed,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

Blend Deployment RAG Document Retrieval Java Code Indexing MCP Server Vector Search pgvector Ollama Embedding Model Management

支持客户端

Zed

适用场景

Blend DeploymentRAGDocument Retrieval

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

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

值得选的地方

  • 已适配 Zed,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mcp-server-rag当前 未标注 未标注 未标注 无 2026-10-30
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方godofwar5946上游标注的维护方 godofwar5946
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · java本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-10-30上游最后核验时间

详细介绍

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

MCP Server RAG

中文召回、管理端重排配置及 RTX 5080 / Qwen3-Reranker-4B 启动方式见 重排使用说明。保留现有 BGE-M3 向量,重排默认关闭,部署后可在管理端验证并启用。

本轮工作台升级、数据库迁移、任务与评测接口及验证方式见 升级说明。

Spring AI 2.0.1 的兼容评估、平台迁移范围,以及当前依赖精简和并发向量计算复用,见 版本评估与优化。

基于 Spring Boot 3.4.12、Spring AI MCP、PostgreSQL/pgvector、Ollama 和 Apache Tika 3.2.3 的 RAG 文档与 Java/C/C++ 代码服务。

目录与批量上传

  • 管理页支持创建多级目录、重命名和递归删除。
  • 目录树支持分支折叠、完整路径搜索、定位当前目录和一键全部收起,展开状态会保存在当前浏览器。
  • 文件区提供面包屑和“上一级”导航;上传入口与当前目录整合,不再需要在目录树和独立上传区之间来回滚动。
  • 支持一次选择多个文件并上传到指定目录。
  • 文件保存后进入持久化索引队列,可在任务中心查看进度、取消或重试;上传提交成功与索引发布成功分别显示。
  • 默认两个文件并行索引,文件结束立即领取下一任务;GPU 批次、后台请求并发及阶段耗时说明见 索引提速与调参。
  • 选择具体目录后,顶部“重建索引”只提交该目录及全部下级目录的文件;确认框展示完整路径。“全部文件”和未归类文件的“根目录”状态下,该按钮禁用,需先选择具体目录。
  • 支持选择整个本地文件夹,后端依据 webkitRelativePath 自动创建多级目录并保留原结构。
  • 浏览器会按每批最多 20 个文件、约 80MB 顺序提交,避免大型项目触发 multipart part 数量或请求大小限制。
  • 同名文件只在同一目录内覆盖,不同目录可保存同名文件。
  • 文件可在目录之间移动;递归删除目录时会同步删除文件及其向量切片。
  • 移动文件时使用可按完整路径搜索的目标目录选择器,适合层级较深的项目目录。
  • 选择具体目录后可导出 ZIP;压缩包包含所选目录本身、全部下级目录、空目录以及数据库中保存的原始文件内容。
  • MCP 检索结果中的来源名称包含目录路径,便于区分不同目录中的同名文件。

目录导出 API:```text
GET /api/folders/{folderId}/export
Response: application/zip


## 业务与代码分类检索

- 文件使用独立的 `knowledge_type` 分类,不占用保存 MIME 类型的 `content_type`。
- 类型支持 `ALL`、`BUSINESS`、`CODE`;新文件继承目录或上级目录的默认分类,没有配置时为 `ALL`。
- `ALL` 表示不限制分类,会同时参加业务与代码分类检索;普通 `rag.search` / `rag.ask` 始终查询全部类型。
- 管理页选择具体目录后,可点击“设置检索类型”批量修改当前目录,并可选择是否包含所有下级目录。
- 分类直接保存在 `rag_file`,修改后立即影响查询,不需要重新解析、切片或向量化。
- `business.search` 检索 `BUSINESS + ALL`;`code.search` 检索 `CODE + ALL` 中的 Java 和 XML 代码切片。

目录批量分类 API:```text
PUT /api/folders/{folderId}/knowledge-type
Body: {"knowledgeType":"BUSINESS","recursive":true}

Java、C/C++ 与 XML SQL 索引

  • .java 使用 JDK 21 Compiler Tree API 做 AST 解析,不编译、不运行上传代码,也不要求项目依赖完整。
  • 提取 Java 类、接口、枚举、Record、注解、构造方法和普通方法,并保存准确的起止行号与字符范围。
  • C/C++ 支持 .c、.h、.cc、.cpp、.cxx、.hh、.hpp、.hxx、.inl、.ipp、.tpp;使用 Tree-sitter 语法树提取函数声明/定义、类方法、构造/析构方法、运算符、命名空间、类/结构体/联合体/枚举及类型别名。完整用法和边界见 C/C++ 索引说明。
  • .xml 会识别 MyBatis Mapper 的 namespace,以及 select、insert、update、delete、sql 节点 ID。
  • Java/C/C++ 函数和 XML SQL 按结构生成向量切片;每份源码有文件符号,可按文件名、路径或行号读取。文件级宏、全局声明和类型成员之间的字段也保留在切片中。普通 XML 没有 Mapper SQL 时按源码文本索引。
  • 管理页可以搜索符号、查看带原始行号的类/方法/SQL,也可以通过“文件路径 + 行号”定位所在逻辑;超出阅读预算时会明确标记源码截断。
  • 整个项目文件夹上传时会保留源码目录,并在前端忽略 .git、.idea、.gradle、target、build、out 和 node_modules。

代码管理 API:```text
GET /api/code/symbols?query=UserService&category=CLASS
GET /api/code/symbols?query=worker.cpp&category=FILE
GET /api/code/symbols/{id}/source
GET /api/code/files/source?filePath=src/worker.cpp
GET /api/code/classes/source?className=com.example.UserService
GET /api/code/methods/source?className=UserService&methodName=findById&signature=findById(Long)
GET /api/code/methods/source?className=demo::Worker&methodName=run
GET /api/code/sql/source?namespace=UserMapper&statementId=findById
GET /api/code/location?filePath=src/main/java/demo/UserService.java&line=42
GET /api/code/search?query=根据用户编号查询用户&topK=5


新增的 Spring AI MCP Tools:```text
code.find
code.get_file
code.get_class
code.get_method
code.get_sql
code.get_by_line
business.search
code.search
rag.retrieve
kb.list

文件、类型、函数/方法名和 SQL ID 查询使用关系型数据定位;business.search 与 code.search 使用 pgvector 做分类型语义检索,并都支持可选的 folderId 项目范围。

管理端登录与远程访问

  • 登录入口为 /login.html,使用表单登录和服务端 Session。未登录访问 / 或 /index.html 时,服务端直接跳转登录页,不发送工作台 HTML;工作台脚本、样式和管理 API 同样需要登录。
  • 登录成功后进入工作台;退出或会话过期后返回登录页。工作台默认隐藏,验证 Session 后才显示;浏览器后退和切回标签页时重新验证登录状态。
  • 登录成功后,浏览器只保存 HttpOnly 的 JSESSIONID Cookie,不保存用户名、密码或 Authorization 凭证;同一浏览器会自动恢复登录状态。
  • Session 与 Cookie 当前有效期均为 12 小时;主动退出、超时、清除 Cookie 或重启服务后需要重新登录。不同电脑和不同浏览器各自登录一次是正常行为。
  • 管理账号通过 app.security.username/password 配置,没有保存到数据库。密码从环境变量或被 Git 忽略的 config/application-local.yml 读取;当前本机配置已保留,其他环境需自行设置。
  • 远程电脑访问前,需要把“远程电脑在服务端看到的来源 IP”加入 app.security.ip-whitelist,不要填写服务端自己的 IP。被拒绝时 JSON 响应中的 clientIp 就是应核对的地址。
  • 修改账号、密码、白名单或 Session 配置后需要重启服务。MCP /mcp 仍允许匿名访问,不受管理端 Session 和 IP 白名单限制。

认证接口:```text
GET /api/auth/status
POST /api/auth/login
POST /api/auth/logout


## 数据库升级

已具有目录、代码索引和分类表的当前库,在启动时自动执行专业工作台迁移。更早版本的数据库需先补齐下面三个历史迁移:```powershell
psql -U postgres -d postgres -v ON_ERROR_STOP=1 -f src/main/resources/db/folder-migration.sql
psql -U postgres -d postgres -v ON_ERROR_STOP=1 -f src/main/resources/db/code-index-migration.sql
psql -U postgres -d postgres -v ON_ERROR_STOP=1 -f src/main/resources/db/knowledge-type-migration.sql

三个历史迁移脚本均可重复执行。新数据库可在同一个 psql 连接内按顺序执行基础结构和工作台迁移:```powershell
psql -U postgres -d postgres -v ON_ERROR_STOP=1 -f src/main/resources/db/schema.sql -f src/main/resources/db/professional-migration.sql


工作台迁移继承连接中的 search_path,不主动切换 schema。上述手工脚本之后,首次启动还需开启 `app.database.migrate-schema=true`,完成模型管理迁移。详细启动配置见 升级说明。

## 管理端切换 Embedding 模型

登录后进入 **服务与模型 → Embedding 模型**,选择 Ollama 中已安装的模型,点击“验证模型”,再点击“切换并重建全部索引”。支持实际维度检测、自定义输出维度、查询指令、进度查看、取消和断点重试。

重建覆盖全库已发布的业务与代码切片。后台生成新模型向量,完成后统一切换;期间旧索引继续可用。结果持久化,重启后继续使用管理端选择的模型。首次部署需要数据库结构迁移,操作步骤与高维模型说明见 模型管理说明。

## 运行```powershell
$env:JAVA_HOME='D:\work\java\jdk21'
$env:Path="D:\work\java\jdk21\bin;D:\work\java\Maven\apache-maven-3.8.4\bin;$env:Path"
mvn clean package
mvn spring-boot:run

启动后访问 http://localhost:8082/,MCP Streamable HTTP endpoint 为 http://localhost:8082/mcp。

Java AST 解析依赖完整 JDK 的 jdk.compiler 模块,因此运行服务时也必须使用 JDK 21,不能改用裁剪掉编译器模块的 JRE。

上传限制为单文件 50MB、单次请求 100MB;Tomcat 的 multipart part 上限通过 server.tomcat.max-part-count: 2000 配置。修改这些配置后需要重启服务。

主要配置见 src/main/resources/application.yml,完整项目约束见 AGENT.md。

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

mcp-server-rag 怎么在 Zed 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

mcp-server-rag 收费吗?

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

mcp-server-rag 需要 API Key 吗?

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

mcp-server-rag 支持哪些客户端?

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

mcp-server-rag 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、RAG、Document Retrieval、Java、Code Indexing、MCP Server。具体工具清单以官方文档为准。

mcp-server-rag 需要什么运行环境?

运行时为 java。

热门专题

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

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