بحث للقراءة فقط عن الكتب والمؤلفين في Open Library

لمن يناسب

يناسب من يريد أن يبحث المساعد عن معلومات الكتب والمؤلفين في Open Library. يصفه النص الرسمي كخادم MCP لواجهة Open Library API، يُستخدم لـ search for book and author information. عنوان المستودع يقول أيضًا إنه يتحدث إلى Open Library API لدى Internet Archive.

هذا ليس دليل مقتنيات محليًا ولا نظام إعارة. كل أداة مسمّاة بحث للقراءة فقط. لا يظهر حقل API key في الإعداد الرسمي.

الصفحة الرسمية:

https://github.com/8enSmith/mcp-open-library

إنهاء أول تجربة في 3 دقائق

يقول النص الرسمي Nothing to install or build. وجّه العميل إلى هذه الحزمة؛ أول تشغيل يسحبه npx:

{
  "mcpServers": {
    "mcp-open-library": {
      "command": "npx",
      "args": ["-y", "mcp-open-library"]
    }
  }
}

من v1.0.3 يُنشر في official MCP Registry باسم io.github.8enSmith/mcp-open-library؛ العملاء الذين يدعمون السجل يمكنهم التثبيت بهذا الاسم. لا تبحث عن مثبّت لم يظهر.

الشرط المسبق: هذا الجهاز يستطيع تشغيل npx. في التجربة الأولى استخدم عنوان كتاب أو اسم مؤلف تعرفه أصلًا؛ لا تخترع ISBN أو Author Key. النص الرسمي لا يطلب سرًا.

موضع الإعداد: mcpServers.mcp-open-library. النص الرسمي لا يسمّي منتج عميل إلزاميًا ولا مسار ملف إعداد.

يجب أن يستخدم الاستدعاء الأول الأداة المذكورة search_books. يمكنه البحث بأي تركيب من query وtitle وauthor وsubject وplace وperson وpublisher وISBN. النجاح: تعود صفحة نتائج مع num_found؛ limit الافتراضي 10 والحد الأقصى 50. لا تستدعِ أولًا get_author_info الذي يحتاج Author Key.

readOnlyHint ليست صفر مخاطر. يكتب النص الرسمي أيضًا openWorldHint: تغادر الطلبات هذا الجهاز وتصل إلى Open Library API. قد يتخطى العميل مربع تأكيد «هذا سيغيّر أشياء» لكن حد الشبكة والخصوصية يبقى.

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

الحالة الأولى: إيجاد كتب بشروط مركّبة. استدعِ search_books. النتائج صفحات: كل صفحة فيها حتى limit عنصرًا (default 10, maximum 50)، اقلب الصفحات بـ offset (maximum 1000) ويُعاد num_found. النص الرسمي لا يصف ترتيبًا ولا مرشح لغة.

الحالة الثانية: بحث أضيق حسب العنوان أو اسم المؤلف. استدعِ get_book_by_title أو get_authors_by_name. النص الرسمي يقول فقط البحث بـ title / name؛ بلا قواعد تطابق ضبابي. إن كان لديك أصلًا Open Library Author Key فيمكن استخدام get_author_info للتفاصيل؛ بلا Key لا تخترع واحدًا.

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

حد القدرة: الأدوات المذكورة في الملاحظات المتتالية هي search_books وget_book_by_title وget_authors_by_name وget_author_info. لا تكمّل أدوات غلاف أو جلب بالمعرّف لم تظهر.

حد الصفحات: limit الافتراضي 10 والحد الأقصى 50؛ offset الحد الأقصى 1000. لا تفترض صفحات تتجاوز الأرقام الرسمية.

حد التثبيت: السحب بـ npx أو اسم السجل io.github.8enSmith/mcp-open-library. النص الرسمي لا يصف ذاكرة مؤقتة دون اتصال.