PDF语义搜索服务

一个轻量级的MCP服务器,用于加载本地PDF文件,提取和分块内容,构建语义搜索索引,并将相关段落发送到Claude Desktop进行基于文档的问答。

  • by AIMIZING
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aimizing/mcp_docs_reader

使用说明

mcp文档阅读器

一个轻量级的MCP(模型上下文协议)服务器,它从本地文件夹加载PDF文件,提取并分块其内容,构建语义搜索索引,并将相关段落发送到Claude Desktop进行基于文档的问答。

本项目旨在与 Claude的MCP桌面功能.


特性

  • 从本地加载和处理PDF文档 docs/ 文件夹
  • 提取文本并将其拆分为语义块
  • 使用SentenceTransformer生成向量嵌入
  • 构建基于FAISS的语义搜索向量索引
  • 基于用户查询检索前k个相关块
  • 构造一个提示(相关段落+问题)并将其返回给Claude
  • 使用最少的设置 紫外线

如何使用

1.安装Claude Desktop(如果未安装)

2.下载 mcp-docs-reader

选项1:以ZIP格式下载

  • 点击 “代码” > “下载ZIP”
  • 解压缩下载的ZIP文件

选项2:使用Git进行克隆

git clone https://github.com/AIMIZING/mcp_docs_reader.git
cd mcp_docs_reader

3.设置紫外线环境

选项1:手动设置

  • 安装uv(如果未安装):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • 设置虚拟环境:
uv venv
.venv\Scripts\activate
  • 安装依赖项:
pip install -r requirements.txt

选项2:自动设置(Windows)

  • 运行包含 “setup.bat” 文件

4.配置克劳德桌面

打开包含的 “weather_config.json” 文件,并复制其内容。 然后,打开现有的Claude Desktop配置文件并附加复制的内容。

要查找Claude Desktop配置文件,请执行以下操作:

  • 打开克劳德桌面
  • 进入菜单→ File → 设置→ 开发人员模式→ 编辑配置
  • 这将打开您的当前 “claude_desktop_config.json” 文件
  • 将附加内容粘贴到适当的位置(例如在mcp列表或相关部分内)

⚠️ 复制之前,请确保替换路径 docReader_gonfig.json中的“C:\PATH\TO\mcp.docs_reader” 使用您的实际本地项目路径(例如C:\Users\YourName\Documents\mcp_docs_reader)。

⚠️ 不要覆盖整个文件——确保附加或合并内容,以避免破坏现有配置。

5.运行克劳德桌面

启动克劳德桌面。 一旦运行,它将自动检测并连接到配置的MCP工具。 现在,您可以根据本地PDF文档向Claude提问,例如:

“总结注册文件内容中的关键点。”