Claude Desktop + pdfmcp: hướng dẫn thiết lập

Thêm pdfmcp vào Claude Desktop dưới dạng một máy chủ MCP cục bộ.

Chỉ cục bộ. Cùng 74 công cụ đó, chạy trên máy của bạn: không tài khoản, không khóa, không giới hạn. Với Claude Desktop, cấu hình trên trang này chạy pdfmcp trên máy của bạn; bạn có thể cài đặt lại hoặc đổi ứng dụng khách bất cứ lúc nào bằng cách hoán đổi cấu hình.

Những gì bạn cần: gói pdfmcp cục bộ: cài đặt nó một lần (hoặc để uvx tải nó xuống khi khởi động lần đầu). Không tài khoản, không khóa và không bí mật nào để thay thế.

Nó đi đâu: claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

Các bước

Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
Fully restart Claude Desktop.
Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

Khắc phục sự cố

Máy chủ cục bộ không khởi động: cài gói một lần bằng pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl và chạy pdfmcp trong terminal để xem lỗi — thường là tải gói bị chặn, hoặc Python cũ hơn 3.11.
Các công cụ không xuất hiện: khởi động lại hoàn toàn ứng dụng khách sau khi chỉnh sửa cấu hình của nó; hầu hết các ứng dụng khách chỉ tải máy chủ MCP khi khởi động.
Một động cơ không khởi động: các động cơ nặng được tải xuống chỉ một lần khi sử dụng lần đầu; kiểm tra kết nối của bạn cho lần tải đó và thử lại: sau đó mọi thứ chạy cục bộ.

Thử với

Trên thiết bịPDF sang văn bảnTrích xuất văn bản thuần, một phần tách bằng form-feed cho mỗi trang.Trên thiết bịNén PDFGiảm kích thước tệp bằng Ghostscript. Cài sẵn: nhẹ (chất lượng máy in), trung bình (sách điện tử), nặng (màn hình, nhỏ nhất).Cục bộ · MCPOCR — PDF có thể tìm kiếmLàm cho PDF đã quét có thể tìm kiếm: các trang không có lớp văn bản được OCR bằng Tesseract và nhận một lớp văn bản vô hình; các trang đã có văn bản được chuyển qua và báo cáo là đã bỏ qua.

Ứng dụng khách khác: Claude Code thiết lập MCP · ChatGPT thiết lập MCP · Cursor thiết lập MCP · Tất cả hướng dẫn thiết lập MCP · Hướng dẫn API cục bộ