Bắt đầu với pdfmcp
Ba cách cục bộ để dùng pdfmcp: các công cụ web miễn phí trên thiết bị của bạn, máy chủ MCP cục bộ cho các tác nhân AI và API cục bộ từ mã của chính bạn, mỗi cách sẵn sàng trong khoảng một phút.
Ba cách dùng pdfmcp, tất cả đều cục bộ
pdfmcp là một hộp công cụ có ba cánh cửa, và cả ba đều ở phía bạn. Các công cụ web của trang web này chạy trong trình duyệt của bạn, trên thiết bị của bạn: tệp của bạn không bao giờ được tải lên và bạn không cần đăng ký bất cứ thứ gì. Máy chủ MCP cục bộ phơi bày cùng những thao tác đó dưới dạng các công cụ có kiểu mà các tác nhân AI như Claude và Cursor có thể gọi trực tiếp, chạy trên máy của bạn. Và API cục bộ cho phép bạn gọi cùng những thao tác đó từ mã của chính bạn, cũng trên máy của bạn.
Cả ba đều miễn phí mãi mãi. Không gói trả phí, không hình mờ, không đồng hồ dùng thử, không tài khoản, không khóa và không hạn mức hằng ngày: thiết bị của bạn làm công việc, vì vậy thiết bị của bạn là giới hạn thực tế duy nhất.
Cách 1: Dùng một công cụ web (không đăng ký)
Mở chỉ mục công cụ và chọn thứ bạn cần: gộp, chia, nén, chuyển đổi, OCR, ký, che và nhiều hơn nữa. Các công cụ được đánh dấu «Trên thiết bị của bạn» xử lý tệp của bạn hoàn toàn trong tab trình duyệt này: thả tệp, điều chỉnh các tùy chọn và tải xuống kết quả. Không có gì được truyền cho chúng tôi, vì vậy không có gì để lưu trữ, ghi lại hay rò rỉ.
Một số thao tác cần bộ máy nặng (OCR đầy đủ, chuyển đổi Office, mật mã học). Những trang đó được đánh dấu «Cục bộ · MCP» và giải thích cách chạy công việc cục bộ bằng gói, trên máy của bạn, với cùng quyền riêng tư.
Cách 2: Cài đặt gói cục bộ
Gói được cài đặt chỉ một lần bằng lệnh cài đặt trên trang MCP. Sau đó, nó chạy hoàn toàn trên máy của bạn: không tài khoản để tạo, không khóa để sao chép và không có gì hết hạn.
Các động cơ nặng (qpdf, dữ liệu ngôn ngữ OCR) được tải xuống chỉ một lần, có xác minh SHA-256, khi sử dụng lần đầu và ở lại trên máy của bạn cho những lần sử dụng tiếp theo.
Cách 3: Kết nối máy chủ MCP cục bộ với tác nhân AI của bạn
Máy chủ MCP chạy cục bộ (stdio) trên cùng máy với tác nhân của bạn. Hầu hết các ứng dụng khách chấp nhận dạng cấu hình này, trong đó ứng dụng khách khởi động gói cho bạn:
{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}Khởi động lại ứng dụng khách của bạn sau khi chỉnh sửa cấu hình của nó; các công cụ pdfmcp sẽ xuất hiện trong danh sách của nó. Các hướng dẫn từng bước cho 13 ứng dụng khách (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains và bất kỳ ứng dụng khách MCP nào khác) được liên kết từ trang MCP. ChatGPT không thể bắt đầu các tiến trình cục bộ, vì vậy bên trong ChatGPT không có cánh cửa cục bộ: hãy dùng một trong các ứng dụng khách cục bộ thay thế.
Lần gọi cục bộ đầu tiên của bạn
Từ mã của chính bạn hoặc thiết bị đầu cuối của bạn, dòng chảy vẫn như thường lệ, nhưng không có máy chủ từ xa: cài đặt gói, chọn một thao tác và chạy nó trên một tệp trên máy của bạn. Thao tác đọc tệp cục bộ và ghi kết quả cục bộ.
Danh mục thao tác của trang web này (mỗi thao tác, các tham số và lược đồ của nó) cũng mô tả gói cục bộ, vì đó là cùng một danh mục: những gì bạn thấy trên các trang công cụ là những gì tác nhân và mã của bạn có thể gọi.
Giới hạn và quyền riêng tư, một cách nghiêm túc
Các giới hạn duy nhất là của thiết bị của bạn: bộ nhớ, tốc độ và, trong trình duyệt, các tệp lên tới khoảng 100 MB và 500 trang. Không có hạn mức để tiêu xài và không có hàng đợi để chờ.
Quyền riêng tư mang tính kiến trúc. Mọi thứ chạy cục bộ, vì vậy tệp của bạn không bao giờ rời khỏi máy của bạn, không bao giờ được lưu trữ trên bất kỳ máy chủ nào và không bao giờ được dùng để huấn luyện AI. Thứ duy nhất trang web này thu thập là phân tích trang (lượt xem và Google Analytics tổng hợp), thứ không bao giờ chạm vào tài liệu của bạn.
Kết nối tác nhân AI của bạn — máy chủ MCP cục bộ miễn phí
Câu hỏi thường gặp
pdfmcp có thực sự miễn phí không?
Có, miễn phí mãi mãi. Mọi công cụ đều chạy cục bộ, không tài khoản và không hình mờ. Không có gói trả phí: một hộp quyên góp tùy chọn (hiện đã tắt) là toàn bộ mô hình kinh doanh.
Tôi có cần tài khoản không?
Không. Không có tài khoản trong pdfmcp: không cho các công cụ web, không cho máy chủ MCP cục bộ và không cho API cục bộ.
Tệp của tôi đi đâu?
Không đi đâu cả: việc xử lý diễn ra trên thiết bị hoặc máy của bạn, và tệp của bạn không bao giờ được tải lên và không bao giờ được dùng để huấn luyện AI.
Tác nhân của tôi gọi máy chủ MCP cục bộ như thế nào?
Ứng dụng khách của bạn khởi động gói pdfmcp dưới dạng một tiến trình cục bộ (stdio) với cấu hình từ các hướng dẫn. Không có tiêu đề bí mật nào để cấu hình, vì không có máy chủ từ xa.
Có giới hạn hằng ngày nào không?
Không. Không hạn mức hằng ngày, không nhịp hằng giờ và không bộ đếm: thiết bị của bạn là giới hạn thực tế duy nhất.
Tôi có thể dùng pdfmcp ngoại tuyến không?
Phần lớn là có: sau khi trang và các thư viện của nó đã tải, các công cụ web hoạt động trong trình duyệt của bạn, và gói cục bộ hoạt động trên máy của bạn. Chỉ việc tải xuống động cơ khi sử dụng lần đầu mới cần kết nối.
Được xuất bản lần đầu tại https://pdfmcp.org/guides/getting-started/