MCP Docs Reader

🚀 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 實現最小化設置。