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

Thêm pdfmcp vào Windsurf Cascade qua mcp_config.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 Windsurf, 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

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

Các bước

1. Save the config at the location above — uvx fetches the pdfmcp package on first launch, so there is nothing to install by hand (or install it once with the pip command on the MCP page and use "command": "pdfmcp").
2. Restart Windsurf so it loads the new server.
3. Ask the agent to run a pdfmcp tool — it executes on this machine, and your files never leave it.

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 · Claude Code thiết lập MCP · ChatGPT 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ộ