ezpzfile MCP
نگذارید عامل‌تان همان کد فایل را دوباره بنویسد
مجموعه‌ای از ابزارها برای عامل‌هایی مثل Claude و Cursor. ویرایش یک PDF، خواندن یک سند، تغییر قالب، مرتب کردن یک تصویر: هرکدام به یک فراخوان تبدیل می‌شود. همه چیز روی رایانه خودتان اجرا می‌شود، پس هیچ فایلی جایی فرستاده نمی‌شود.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpکجا کار می‌کند
چه چیزی عوض می‌شود
پیش از وصل کردن
سه چهار رفت و برگشت- 1دنبال کتابخانه‌ای به‌دردبخور گشتن و نصب کردنش.
- 2نوشتن اسکریپت، برخوردن به نتیجه‌ای کج و درست کردنش.
- 3باز کردن خروجی فقط برای دیدن اینکه درست شده یا نه.
پس از وصل کردن
یک فراخوان- 1ابزار را یک بار صدا بزنید.
- 2فایل نتیجه همان‌جا کنار اصل ساخته می‌شود.
- 3بررسی تعداد صفحه و شمار آنچه منتقل نشده هم با آن برمی‌گردد.
چقدر صرفه‌جویی می‌کند
همان چهار فایل در دو نشست گذاشته شد و همان جملهٔ کار به همان مدل داده شد. یک طرف فقط اجازه داشت از این سرور استفاده کند. طرف دیگر هیچ ابزار اختصاصی نداشت و می‌توانست آزادانه از پوسته و Node استفاده کند.
−53%
کاهش هزینه
−93%
کاهش زمان
| دست‌خالی | ezpzfile MCP | |
|---|---|---|
| هزینه | $0.28 | $0.13 |
| زمان صرف‌شده | 9:06 | 0:39 |
| کارهای تمام‌شده | 2 / 4 | 4 / 4 |
| فراخوان ابزار | 20 | 10 |
| توکن مصرف‌شده | 510,607 | 184,605 |
چهار کاری که خواسته شد
- 1چسباندن دو PDF و حذف سه صفحه
- 2کوچک کردن عکس به عرض ۱۲۰۰ و پاک کردن داده مکان
- 3تبدیل یک سند HWP به PDF
- 4بیرون کشیدن متن از یک سند HWP
طرف دست‌خالی فقط دو کار از چهار کار را تمام کرد. در دو سند کره‌ای تمام وقتش صرف پیدا کردن و نصب کتابخانه شد و اصلاً شروع نکرد. پس فاصلهٔ بالا را باید «دست‌کم این‌قدر» خواند. اگر وادار می‌شد هر چهار کار را تمام کند، فاصله بیشتر می‌شد.
توکن و هزینه تخمین نیست، بلکه عددهای واقعی است که هر نشست برای هر پیام ثبت کرده و با هم جمع شده است. تاریخ اندازه‌گیری: 2026-09-12
سی و یک کار، شش ابزار
ابزارهای سایت اینجا یکی‌یکی فهرست نشده‌اند. توضیح هر ابزار در هر گفت‌وگو در بافتار مدل می‌نشیند، پس باز کردن سی و یک تا از آن‌ها همان توکنی را می‌خورد که می‌خواهیم نگه داریم. کارهایی که یک‌جور کار می‌کنند کنار هم گذاشته شده‌اند و یک آرگومان بینشان انتخاب می‌کند.
doc_readمتن را از فایل‌های DOCX و PDF و HWP و HWPX و EML و JTD و XDW بیرون می‌کشد، همراه با جدول‌ها و سرصفحه‌ها، و آنچه فایل درباره خودش نگه داشته را هم نشان می‌دهد، مثل جای گرفتن عکس.doc_convertسند به PDF (از جمله JTD و XDW ژاپنی)، PDF به Word یا Excel یا HWP، صفحه‌های PDF به JPG یا PNG، صفحه‌گسترده به CSV یا JSON، و قالب‌های کره‌ای به یکدیگر.pdf_editPDF را به هم می‌چسباند، جدا می‌کند، صفحه پاک می‌کند، می‌چرخاند، ترتیب را عوض می‌کند، حجم را کم می‌کند، رمز می‌گذارد یا برمی‌دارد و متن را سر جایش عوض می‌کند.pdf_infoتعداد صفحه، اندازه صفحه‌ها و اطلاعات سند یک PDF را برمی‌گرداند.image_editاندازه و حجم تصویر را کم می‌کند (از جمله HEIC آیفون)، قالب را عوض می‌کند، پس‌زمینه را برمی‌دارد و داده مکان و دوربین را پاک می‌کند.qr_makeیک پیوند یا یک متن را به کد QR تبدیل می‌کند که می‌شود چاپ و پخشش کرد.
تازه‌های نسخهٔ 0.4.0
شش ابزار حالا سی و یک کار سایت را انجام می‌دهند. پیش‌تر بیست و پنج کار بود. قابلیت‌های تازه به‌صورت گزینه‌هایی روی ابزارهای موجود اضافه می‌شوند، برای همین فهرستی که عامل شما در آغاز هر گفت‌وگو بار می‌کند تقریباً بلندتر نشده است.
ezpzfile-mcp@0.4.0
برگرداندن PDF به Word، Excel و HWP
بندها و جدول‌ها به‌صورت متن قابل ویرایش برمی‌گردند. ابزار فایلی را که نوشته دوباره باز می‌کند تا وارسی‌اش کند، و صفحه‌هایی را که ناچار کنار گذاشته فهرست می‌کند، مثل صفحهٔ اسکن‌شدهٔ بی‌متن.
doc_convert to: docx | xlsx | hwp | hwpxعوض کردن متن داخل PDF
یک واژه یا عبارت را در همان جای خودش عوض می‌کند، با قلم خود PDF اگر حرف‌های لازم را داشته باشد. بعد می‌شمارد چندتا مانده است تا هیچ جایی از قلم نیفتد.
pdf_edit op: replace_textIchitaro و DocuWorks
فایل‌های ژاپنی Ichitaro و DocuWorks (JTD و XDW و XBD) را بدون هیچ‌یک از این دو برنامه می‌خواند و به PDF تبدیل می‌کند. فایل‌های Ichitaro را می‌شود به Word هم تبدیل کرد.
doc_read · doc_convert .jtd .xdw .xbdعکس‌های iPhone با قالب HEIC
عکس‌های HEIC را کوچک می‌کند، قالبشان را عوض می‌کند و همراه تصویرهای دیگر در یک PDF کنار هم می‌گذارد. خروجی JPEG، PNG یا WebP است.
image_edit .heicآنچه فایل دربارهٔ خودش می‌گوید
نشان می‌دهد عکس کجا و با کدام دوربین گرفته شده، یا سند را چه کسی و کی نوشته است. فقط دیدن چیزی را عوض نمی‌کند. برای پاک کردنش از عکس‌ها و PDFها از image_edit strip_metadata استفاده کنید.
doc_read format: metadataپاسخ روشن وقتی HWP باز نمی‌شود
می‌گوید فایل در واقع چیست: PDF یا Word با نام اشتباه، دانلودی که نیمه‌کاره مانده، یا نسخه‌ای که سامانهٔ امنیتی شرکت (DRM) قفلش کرده است. اگر موتور سر یک فایل از کار بیفتد، فایل بعدی باز هم پردازش می‌شود.
doc_read "Only the name says HWP: this is a PDF."
یک فراخوان چقدر طول می‌کشد
با سروری که از پیش بالا بود، هر فراخوان پنج بار زمان‌گیری شد و مقدار میانی ثبت شد. ورودی‌ها یک PDF پانزده صفحه‌ای ۲٫۲ مگابایتی، یک فایل HWP ۳۴۲ کیلوبایتی و یک JPEG با ابعاد 3000x2000 بود.
| فراخوان | میانه |
|---|---|
image_edit · strip_metadata | 1ms |
qr_make | 4ms |
image_edit · resize | 16ms |
doc_read · pdf | 117ms |
pdf_info | 157ms |
doc_read · hwp | 342ms |
pdf_edit · merge | 657ms |
doc_convert · pdf→jpg | 803ms |
pdf_edit · compress | 1,168ms |
doc_convert · hwp→pdf | 1,541ms |
pdf_edit · protect | 2,821ms |
360ms
از بالا آمدن سرور تا نخستین پاسخ
~2,000
توکنی که فهرست ابزارها در هر گفت‌وگو می‌گیرد
نصب
ابزاری را که استفاده می‌کنید انتخاب کنید و یک خط را کپی کنید.
claude mcp add ezpzfile -- npx -y ezpzfile-mcpیک بار در هر پایانه‌ای اجرایش کنید.
Node 22.13 یا جدیدتر کافی است. بار اول بسته دانلود می‌شود و بعد از آن از حافظه نهان بالا می‌آید.
بعد از وصل شدن می‌توانید این‌طور بخواهید
- “chapter1.pdf و chapter2.pdf را به هم بچسبان و صفحه ۳ را بردار”
- “~/Downloads/quote.pdf را به فایل Word قابل ویرایش تبدیل کن”
- “در contract.pdf همهٔ ACMEها را به Globex عوض کن”
- “این عکس‌ها را به عرض ۱۲۰۰ کوچک کن و داده مکان را هم پاک کن”
- “~/Downloads/notice.hwp را به PDF تبدیل کن”
- لازم نیست برای هر فایل کد تبدیل نوشته و درست شود. ابزارهای لازم از قبل وصل‌اند.
- هر نتیجه دوباره خوانده می‌شود تا تعداد صفحه تأیید شود، و هرچه منتقل نشده باشد شمرده می‌شود.
- همه چیز روی رایانه خودتان اجرا می‌شود. هیچ فایلی بارگذاری نمی‌شود، پس سندهای محرمانه را هم می‌شود سپرد.
پرسش‌های پرتکرار
واقعاً فایل‌ها از دستگاه بیرون نمی‌روند؟+
هرگز نمی‌روند. موتورهای سند و قلم‌ها داخل خود بسته هستند، پس خواندن و تبدیل بدون اینترنت انجام می‌شود. تنها دانلود، بار اولی است که پس‌زمینهٔ عکسی را حذف می‌کنید: مدل برش پس‌زمینه (حدود ۱۸ مگابایت) یک بار از ezpzfile.com گرفته می‌شود و روی دیسک می‌ماند. عکس شما به هیچ جا فرستاده نمی‌شود. مخزن باز است و می‌توانید خودتان وارسی کنید.
هزینه‌ای دارد؟+
ندارد. با پروانهٔ MIT روی npm منتشر شده است. نه حساب می‌خواهد نه کلید.
در ChatGPT یا Grok کار می‌کند؟+
هنوز نه. آن دو فقط سرورهای MCP دور را می‌پذیرند که با نشانی وصل می‌شوند. این یکی عمداً روی رایانهٔ خودتان اجرا می‌شود تا فایل‌ها از آن بیرون نروند. در Claude و Cursor و VS Code و Gemini CLI همین امروز کار می‌کند.
برای فایل‌های HWP به بستهٔ اداری کره‌ای نیاز دارم؟+
نیازی نیست، به ویندوز هم نه. موتوری که سندهای کره‌ای را می‌خواند و می‌کشد همراه بسته می‌آید، پس روی macOS و لینوکس هم یکسان کار می‌کند.
چرا فقط شش ابزار؟+
توضیح هر ابزار در آغاز هر گفت‌وگو وارد بافتار مدل می‌شود. اگر هر یک از سی و یک کار ابزار جداگانه‌ای می‌شد، همان فهرست توکنی را که می‌خواهیم نگه داریم می‌خورد. برای همین کارهایی که یک‌جور کار می‌کنند کنار هم گذاشته شده‌اند و یک آرگومان بینشان انتخاب می‌کند. توانایی‌ها زیاد می‌شود، ابزارها نه.
از کجا بدانم نتیجه درست درآمده؟+
خود ابزار وارسی می‌کند و می‌گوید. فایلی را که تازه نوشته دوباره می‌خواند تا تعداد صفحه را بسنجد و نویسه‌هایی را که در قلم نبوده می‌شمارد. هدف این است که نتیجهٔ بی‌صدا خراب‌شده همین حالا به شکل یک عدد دیده شود، نه بعداً به شکل یک غافلگیری.
یک خط و وصل می‌شود
در پایانه بچسبانید و یک فایل به عامل‌تان بسپارید. اگر خواستید برش دارید، یک خط از پیکربندی پاک کنید.
claude mcp add ezpzfile -- npx -y ezpzfile-mcp