Langkau ke kandungan
Kembali ke Blog
tutorial
16 Jun 2026
GuruPDF Team
6 min untuk baca

Tukar Fail dalam Claude dan Cursor dengan GuruPDF MCP

GuruPDF ialah pelayan MCP penukaran fail: tukar PDF ke Word, imej ke PDF, serta gabung, mampat dan OCR — terus dalam Claude, Cursor, atau mana-mana klien MCP.

Ejen pengkodan anda boleh merangka aplikasi, merungkai stack trace, dan berdebat dengan anda tentang tabs versus spaces. Namun serahkan PDF dan minta dokumen Word yang boleh diedit, ia terus tersekat. Fail berada di cakera anda; model berada dalam chat. Tiada apa yang menghubungkan keduanya.

Jurang itulah sebab sebenar kami membina GuruPDF MCP — pelayan kecil yang memberi Claude, Cursor, dan mana-mana klien MCP lain cara untuk benar-benar menukar fail. Masukkan laluan dalam prompt anda, nyatakan apa yang anda mahu, dan fail yang ditukar kembali ke cakera anda sebentar kemudian. Tiada skrin muat naik, tiada "muat turun, kemudian muat naik semula ke tempat lain." Hanya "convert ~/contracts/lease.pdf to Word."

Apakah sebenarnya MCP penukaran fail

MCP — Model Context Protocol — ialah palam yang membolehkan ejen AI menggunakan alat di luar kepalanya sendiri. Pelayan menawarkan beberapa tindakan; ejen memanggilnya apabila prompt anda memerlukannya. Terdapat pelayan MCP untuk pangkalan data, pelayar, GitHub.

Tiada yang bagus untuk fail. Jadi PDF MCP — sebenarnya MCP penukaran fail, kerana jangkauannya jauh melepasi PDF — hanyalah pelayan yang mengambil fail dalam satu format dan mengembalikan format lain. PDF kepada Word. Folder imej kepada satu PDF. Halaman imbasan kepada teks yang boleh dicari. Ejen yang meminta; GuruPDF yang menukar.

Di sebalik tabir, ia enjin yang sama di sebalik gurupdf.com: 126 alat, 100+ format, kini boleh dicapai dari dalam editor anda.

Sediakannya dalam kira-kira dua minit

Anda perlukan dua perkara: Node (untuk npx) dan kunci API GuruPDF percuma. Dapatkan kunci di gurupdf.com/profile — akaun percuma datang dengan kredit harian, jadi anda boleh mula menukar terus.

Pelayan memasang dan menjalankan dirinya melalui npx; tiada apa yang perlu diklon:

bash
npx gurupdf-mcp

Namun anda tidak akan menjalankannya secara manual — anda arahkan klien MCP anda kepadanya. Untuk Cursor, Claude Desktop, VS Code, atau Windsurf, masukkan ini ke dalam konfigurasi MCP anda:

json
{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Mulakan semula klien dan ejen anda secara senyap mendapat empat alat: menukar fail, menyemak tugasan, menyenaraikan apa yang disokong, dan menyemak baki kredit anda. Itu sahaja persediaannya.

Apa yang anda benar-benar boleh lakukan dengannya

Ini bahagian yang menyeronokkan. Setelah disambungkan, ini gesaan sebenar yang terus berfungsi:

  • "Tukar ~/Downloads/invoice.pdf kepada Word supaya saya boleh edit jumlahnya." — fail .docx yang boleh diedit muncul di sebelah fail asal.
  • "Tukarkan setiap tangkapan skrin dalam ~/shots menjadi satu PDF." — imej digabungkan, mengikut urutan, menjadi satu fail.
  • "Imbasan ini hanyalah imej. OCR-kannya dan berikan saya teksnya." — teks sebenar dikeluarkan semula daripada piksel.
  • "Mampatkan report.pdf, saiznya 40 MB dan saya perlu e-melkannya." — fail yang lebih kecil tetapi masih boleh dibaca.
  • "Buatkan PDF daripada https://example.com/pricing." — halaman langsung, dirender kepada PDF.

Anda tidak perlu menghafal nama alat atau format. Nyatakan matlamat dalam bahasa biasa dan pelayan memilih yang mana antara 126 alat yang sesuai, menjalankannya, dan menulis hasilnya ke cakera. Gabung, pisah, putar, lindungi dengan kata laluan, tera air, Excel ↔ PDF, HEIC → JPG — semuanya ada.

Ia membalas apabila sesuatu tidak kena

Kebanyakan penukar gagal dengan kod yang kabur. Yang ini dibina untuk menjelaskan dirinya melalui ejen anda, kerana ejen itulah yang membaca balasan.

Apabila kredit peringkat percuma hampir habis, anda tidak akan mendapat 402 kosong. Anda mendapat ayat yang disampaikan pembantu anda: anda telah mencapai had percuma (2 penukaran seminit, 10 sehari), ia ditetapkan semula esok, dan ini pautan jika anda tidak mahu menunggu. Serahkan format yang salah kepada alat, atau fail yang terlalu besar, dan ia memberitahu anda dengan tepat — dalam ayat, bukan nombor ralat. Anda tidak perlu meninggalkan perbualan untuk mengetahui apa yang berlaku.

Idea "jelaskan melalui ejen" itu juga sebab kami teliti dengan pilihan kata. Mesej ralat yang manusia tidak pernah baca masih perlu masuk akal kepada model yang menyampaikannya.

Apa yang ada di sebalik tabir

  • 126 alat, 100+ format. PDF, Word, Excel, PowerPoint, imej, e-buku, malah video — enjin yang sama seperti laman web.
  • Peringkat percuma yang sebenar. Setiap akaun mendapat kredit harian. Pelan berbayar dan pek kredit wujud untuk penggunaan lebih berat, dan ejen anda mengarahkan anda kepadanya apabila benar-benar masuk akal, bukan sebelumnya.
  • Fail tidak kekal. Semua pemindahan melalui HTTPS dan dipadam dalam masa sejam. MCP menulis hasilnya ke cakera anda; salinan di pihak kami hilang tidak lama kemudian.
  • Sumber terbuka. Pelayan berlesen MIT, diterbitkan di npm dan disenaraikan dalam pendaftaran MCP rasmi, jadi anda boleh membaca setiap baris sebelum menjalankannya.

Dapatkannya

Jika anda menghabiskan hari dalam Claude atau Cursor dan sentiasa keluar ke laman web penukar, ini menamatkan pusingan pergi-balik itu.

Tambah sekali dan lupakan kewujudannya — sehingga kali berikutnya anda akan membuka tab pelayar untuk menukar fail, dan ejen anda terus melakukannya.