/ الدليل / الملعب / ebook-mcp
● مجتمع onebirdrocks ⚡ فوري

ebook-mcp

بواسطة onebirdrocks · onebirdrocks/ebook-mcp

وجّه Claude إلى مكتبتك من ملفات EPUB و PDF للحصول على البيانات الوصفية وجدول المحتويات ومحتوى الفصول بصيغة منظمة، بحيث يتمكن النموذج من الاستشهاد والتلخيص بدقة.

يغلف ebook-mcp مكتبات Python الشهيرة للـ EPUB و PDF في أدوات MCP. بخلاف 'قراءة ملف' العام، يكشف عن جدول المحتويات وحدود الفصول، بحيث يمكن لـ Claude جلب الفصل المطلوب فقط بدلاً من تحميل 500 صفحة في السياق.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

ebook.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ebook",
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "ebook": {
      "command": {
        "path": "uvx",
        "args": [
          "ebook-mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add ebook -- uvx ebook-mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: ebook-mcp

البحث عن فقرة واستشهاد بها تتذكرها بشكل غامض

👤 القراء / الباحثون ⏱ ~5 min beginner

متى تستخدمه: 'كان هناك شيء في هذا الكتاب عن X...' — تحتاج الاستشهاد الدقيق وليس لديك رغبة في تقليب الصفحات.

المتطلبات الأساسية
  • ملف الكتاب على القرص — EPUB أو PDF
الخطوات
  1. تحميل جدول المحتويات
    أظهر لي جدول المحتويات لـ ~/Books/deep-work.epub. أي فصل يناقش على الأرجح العمل السطحي مقابل العمل العميق؟✓ تم النسخ
    → جدول المحتويات + أفضل فصل مخمن
  2. سحب الفصل
    احصل على نص الفصل 3. ابحث عن الفقرة حول العمل السطحي كوضع افتراضي.✓ تم النسخ
    → الفقرة المستشهد بها

النتيجة: الاستشهاد في متناول اليد، قابل للاستشهاد به، في دقيقتين.

المزالق
  • ملفات PDF الممسوحة ضوئياً لا تحتوي على طبقة نصية — قم بتشغيل OCR أولاً

توليد ملخص فصل بفصل لكتاب تقني

👤 المهندسون الذين يتعلمون من كتاب في قائمة القراءة الخاصة بهم ⏱ ~30 min intermediate

متى تستخدمه: تريد أن تقرر ما إذا كنت ستقرأ الكتاب فعلاً، أو تحتاج إلى تحديث بعد الانتهاء.

الخطوات
  1. جدول المحتويات أولاً
    حمّل جدول المحتويات لـ book.pdf. أظهر لي عناوين الفصول ونطاقات الصفحات التقريبية.✓ تم النسخ
    → الخطوط العريضة
  2. ملخص لكل فصل
    لكل فصل، حمّل محتواه وأنتج ملخص نقاط 3. أخرج كـ مستند Markdown واحد.✓ تم النسخ
    → ملخص الكتاب الكامل

النتيجة: ملخص كتاب من 1-2 صفحة يمكنك مشاركته أو العودة إليه.

المزالق
  • الكتب الضخمة تستنزف ميزانية الرموز إذا حملت جميع الفصول في نفس الوقت — معالجة فصل واحد في المرة؛ كتابة ملخصات وسيطة إلى القرص
اجمعها مع: filesystem

فحص البيانات الوصفية لمكتبة الكتب الإلكترونية الخاصة بك

👤 مستخدمو Calibre، جامعو الكتب الإلكترونية ⏱ ~15 min beginner

متى تستخدمه: تحتوي مكتبتك على 500 كتاب إلكتروني وتريد العثور على تلك التي تفتقد البيانات الوصفية للعنوان/المؤلف.

الخطوات
  1. مسح
    لكل .epub تحت ~/Books، احصل على البيانات الوصفية. اسرد أي منها حيث يكون العنوان أو المؤلف مفقوداً أو يحتوي على 'Unknown'.✓ تم النسخ
    → قائمة البيانات الوصفية غير المكتملة

النتيجة: فحص نظافة البيانات الوصفية السريع.

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

ebook + local-rag

بناء فهرس مكتبة قابل للبحث

لكل كتاب، احصل على get_chapter فصل تلو الآخر، ادخله في local-rag مع عنوان الكتاب كمصدر.✓ تم النسخ
ebook + notion

ملء دفتر قراءتك تلقائياً

خذ هذا الكتاب الذي انتهيت للتو منه؛ لخص كل فصل؛ أنشئ صفحة Notion في 'الكتب المقروءة'.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
get_metadata path: str الفحص الأول لأي كتاب free
get_toc path: str قبل سحب محتوى الفصل free
get_chapter path, chapter_id or id_range تحميل فصل معين free
get_pages path, from_page, to_page (PDF only) استخراج نطاق الصفحات لملفات PDF free

التكلفة والحدود

تكلفة التشغيل

حصة API
بدون حد
الرموز لكل استدعاء
الفصول 2k-30k رموز اعتماداً على الطول
التكلفة المالية
مجاني (Apache 2.0)
نصيحة
حمّل جدول المحتويات أولاً دائماً. ثم حمّل الفصول واحداً تلو الآخر بدلاً من الكتاب كله.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: بدون — ملفات محلية فقط
نقل البيانات الخارجي: محتوى الكتاب ينتقل إلى مزود LLM الخاص بك

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Unable to parse PDF

ملف PDF الممسوح ضوئياً/الصور فقط لا يحتوي على طبقة نصية. قم بتشغيل ocrmypdf أولاً.

تحقق: pdftotext input.pdf - | head
EPUB chapter ID not found

المعرّفات تأتي من جدول المحتويات بالضبط. استدعِ get_toc أولاً.

Large PDF makes get_chapter timeout

استخدم get_pages بنطاق صفحات أصغر؛ معالجة جماعية.

البدائل

ebook-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Calibre + سكريبت مخصصتريد تكاملاً كاملاً مع Calibreإعداد أكثر؛ بدون غلاف MCP
pdfplumber / pymupdf مباشرةتبني أدواتك الخاصةبناء غلاف MCP الخاص بك

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills