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

Thêm pdfmcp vào Claude Code bằng một lệnh, hoặc qua .mcp.json.

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 Code, 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: Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

Các bước

1. Run the command above (or add the JSON below to .mcp.json in your project root).
2. Restart Claude Code and run /mcp to confirm pdfmcp is connected.
3. Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

Cấu hình

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

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

Ứng dụng khách khác: Claude Desktop 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ộ