🚀 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 实现最小化设置。