Lizeur

🚀 Lizeur - PDF內容提取MCP服務器

Lizeur是一個模型上下文協議（MCP）服務器，它藉助Mistral AI的OCR功能，讓AI助手能夠從PDF文檔中提取並讀取內容。它提供了一個簡單的接口，可將PDF文件轉換為易於被AI模型處理的Markdown文本。

✨ 主要特性

• PDF OCR處理：利用Mistral AI的最新OCR模型從PDF文檔中提取文本。
• 智能緩存：自動緩存已處理的文檔，避免重複處理。
• Markdown輸出：返回簡潔的Markdown文本，便於與AI工作流程集成。
• FastMCP集成：基於FastMCP構建，性能卓越且易於使用。

📦 安裝指南

從pypi安裝

pip install lizeur

並將以下配置添加到您的mcp.json文件中：

⚠️ 重要提示

Lizeur將安裝在python3.10文件夾中。如果該文件夾不在系統的PATH中，您的IDE可能無法檢測到lizeur二進制文件。

💡 使用建議

您可以在命令字段中添加lizeur二進制文件的完整路徑，以確保您的IDE能夠找到它。

{
  "mcpServers": {
    "lizeur": {
      "command": "lizeur",
      "env": {
        "MISTRAL_API_KEY": "your-mistral-api-key-here",
        "CACHE_PATH": "your cache path",
      }
    }
  }
}

手動安裝

1. 克隆倉庫

git clone https://github.com/SilverBzH/lizeur
cd lizeur

2. 創建並激活虛擬環境

# 創建虛擬環境
uv venv --python 3.10

# 激活虛擬環境
# 在macOS/Linux上：
source .venv/bin/activate

# 在Windows上：
# .venv\Scripts\activate

3. 安裝依賴並構建

# 安裝依賴
uv sync

# 構建包
uv build

4. 全局安裝

# 全局安裝包
uv pip install --system .

這將在您的系統上全局安裝lizeur命令。

💻 使用示例

可用函數

read_pdf

• 函數：read_pdf
• 參數：absolute_path（字符串） - PDF文件的絕對路徑
• 返回值：完整的OCR響應，包括所有頁面的Markdown內容、邊界框和其他OCR元數據

read_pdf_text

• 函數：read_pdf_text
• 參數：absolute_path（字符串） - PDF文件的絕對路徑
• 返回值：所有頁面的Markdown文本內容，不包含完整的OCR元數據（更易於代理處理）

AI助手中的使用示例

AI助手現在可以像這樣使用這些工具：

What the OP command looks like for this specific controller, here is the doc /path/to/document.pdf

MCP服務器將執行以下操作：

1. 檢查文檔是否已緩存。
2. 如果未緩存，將PDF上傳到Mistral AI進行OCR處理。這將使用您的MISTRAL API密鑰併產生費用。
3. 提取文本並將其轉換為Markdown。
4. 緩存結果以供將來使用。
5. 返回Markdown內容。

⚠️ 重要提示

當您只需要文本內容時，請使用read_pdf_text；當您需要包含元數據的完整OCR響應時，請使用read_pdf。如果PDF文件很大，read_pdf可能會讓某些代理感到困惑。

📚 詳細文檔

本地開發設置

# 以開發模式安裝
uv pip install -e .

# 直接運行服務器
python main.py

項目結構

• main.py - 集成FastMCP的主服務器實現。
• pyproject.toml - 項目配置和依賴項。
• uv.lock - 鎖定的依賴版本。

🔧 技術細節

依賴項

• mcp[cli]>=1.12.4 - 模型上下文協議實現。
• mistralai>=0.0.10 - Mistral AI Python客戶端。

📄 許可證

本項目採用MIT許可證。

📚 支持

如有問題和疑問，請參考項目倉庫或聯繫維護人員。