🚀 mcp-docs-reader 中文翻译版

mcp-docs-reader 是一个轻量级的 MCP（模型上下文协议）服务器，它可以从本地文件夹加载 PDF 文件，提取并分块处理文件内容，构建语义搜索索引，还能将相关段落发送到 Claude Desktop 以实现基于文档的问答功能，助力用户高效利用本地文档进行知识问答。

该项目旨在与 Claude 的 MCP 桌面功能 协同使用。

🚀 快速开始

1. 安装 Claude Desktop（如果尚未安装）

• 下载 Claude Desktop 并按照说明进行安装。

2. 下载 mcp-docs-reader

选项一：下载为 ZIP 文件

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

选项二：使用 Git 克隆仓库

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

3. 配置 UV 环境

选项一：手动配置

• 安装 uv（如果尚未安装）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• 创建并激活虚拟环境：

uv venv
.venv\Scripts\activate

• 安装依赖项：

pip install -r requirements.txt

选项二：自动配置（Windows）

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

4. 配置 Claude Desktop

打开包含的 “weather_config.json” 文件，并复制其内容。 然后，打开您现有的 Claude Desktop 配置文件并将其附加到相应位置。

找到 Claude Desktop 配置文件的位置：

• 打开 Claude Desktop
• 转到菜单 → 文件 → 设置 → 开发者模式 → 编辑配置
• 这将打开您的当前 “claude_desktop_config.json” 文件
• 在适当位置粘贴复制的内容（例如，在 mcp 列表或相关部分）

⚠️ 重要提示

在粘贴之前，请确保将 docReader_config.json 中的路径 "C:\PATH\TO\mcp_docs_reader" 替换为您的实际本地项目路径。

⚠️ 重要提示

请勿覆盖整个文件——确保进行追加或合并，以免破坏现有配置。

5. 运行 Claude Desktop

启动 Claude Desktop。 一旦运行，它会自动检测并连接到配置好的 MCP 工具。 现在您可以基于本地 PDF 文档向 Claude 提问，例如：

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

✨ 主要特性

• 从本地 docs/ 文件夹加载和处理 PDF 文档。
• 提取文本并将其分成语义块。
• 使用 SentenceTransformer 生成句子嵌入。
• 构建基于 FAISS 的向量索引进行语义搜索。
• 根据用户查询检索 top-k 相关块。
• 构造提示（相关段落 + 问题）并返回给 Claude。
• 使用 uv 实现最小化设置。