خادم MCP مصمم لمنصة Scrapbox/Cosense، يدعم استرجاع الصفحات والبحث وإنشاء الوظائف

مشروع خادم Scrapbox Cosense MCP: مقدمة

نظرة عامة على المشروع

scrapbox-cosense-mcp هو خادم MCP (بروتوكول سياق النموذج) مصمم خصيصًا لمنصة cosense/scrapbox. تم تطوير هذا المشروع بواسطة worldnine، ويستضاف على GitHub، ويهدف إلى توفير واجهة موحدة لتطبيقات الذكاء الاصطناعي مع قاعدة معارف Scrapbox.

ما هو Scrapbox/Cosense؟

Cosense هي منصة لإدارة المعرفة، وفكرتها الأساسية هي أن "مفتاح الإنتاجية يكمن في المعرفة". يسمح للمستخدمين بمشاركة الخبرات وتراكم المعرفة وتحقيق النمو المركب للمعرفة بسهولة داخل المؤسسة.

الوظائف الأساسية

1. get_page (الحصول على صفحة)

• وصف الوظيفة: الحصول على محتوى الصفحة من cosense/Scrapbox
• معلمات الإدخال: عنوان الصفحة
• محتوى الإخراج: محتوى الصفحة، والبيانات الوصفية، ومعلومات الارتباط، ومعلومات المحرر

2. list_pages (قائمة الصفحات)

• وصف الوظيفة: الحصول على قائمة الصفحات داخل المشروع
• الشروط المقيدة: إرجاع 1000 صفحة كحد أقصى
• محتوى الإخراج: قائمة بعناوين جميع الصفحات داخل المشروع

3. search_pages (البحث في الصفحات)

• وصف الوظيفة: إجراء بحث كامل النص داخل المشروع
• قدرات البحث: دعم البحث الأساسي، والبحث AND، والبحث OR، والبحث NOT
• الشروط المقيدة: إرجاع 100 نتيجة بحث كحد أقصى
• محتوى الإخراج: قائمة بعناوين الصفحات التي تطابق شروط البحث

4. create_pages (إنشاء صفحات)

• وصف الوظيفة: إنشاء عنوان URL للصفحة
• معلمات الإدخال: عنوان الصفحة ومحتوى النص الأساسي الاختياري
• محتوى الإخراج: عنوان URL يمكن فتحه في المتصفح

التثبيت والتكوين

تثبيت التطوير المحلي

# استنساخ المشروع
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# تثبيت التبعيات
npm install

# بناء الخادم
npm run build

# إعادة البناء التلقائي أثناء التطوير
npm run watch

تكوين التكامل مع Claude Desktop

لاستخدام هذا الخادم في Claude Desktop، تحتاج إلى إضافة إعدادات الخادم في ملف التكوين:

مسار ملف التكوين macOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

مسار ملف التكوين Windows:

%APPDATA%/Claude/claude_desktop_config.json

مثال على التكوين:

{
  "mcpServers": {
    "scrapbox-cosense-mcp": {
      "command": "npx",
      "args": ["github:worldnine/scrapbox-cosense-mcp"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid",
        "COSENSE_PAGE_LIMIT": "25",
        "COSENSE_SORT_METHOD": "created",
        "SERVICE_LABEL": "scrapbox(cosense)"
      }
    }
  }
}

شرح متغيرات البيئة

المتغيرات المطلوبة

• COSENSE_PROJECT_NAME: اسم المشروع (مطلوب)
  • إذا لم يتم تعيينه، فسيتوقف الخادم عن العمل مع وجود خطأ عند بدء التشغيل

المتغيرات الاختيارية

• COSENSE_SID: معرف جلسة مصادقة Scrapbox/Cosense

  • مطلوب للوصول إلى المشاريع الخاصة
  • يمكن الوصول إلى المشاريع العامة فقط في حالة عدم التعيين

• API_DOMAIN: نطاق API (افتراضي: "scrapbox.io")

  • يوفر خيارًا لبعض البيئات التي قد تحتاج إلى استخدام "cosen.se"

• SERVICE_LABEL: معرف الخدمة (افتراضي: "cosense (scrapbox)")

• COSENSE_PAGE_LIMIT: الحد الأولي للحصول على الصفحة (افتراضي: 100)

  • النطاق الفعال: 1-1000
  • يتم استخدام القيمة الافتراضية تلقائيًا عند تجاوز النطاق

• COSENSE_SORT_METHOD: ترتيب الحصول على الصفحة الأولي (افتراضي: "updated")

  • القيم المتاحة: updated/created/accessed/linked/views/title
  • يؤثر فقط على الحصول على الموارد الأولية، ولا يؤثر على أداة list_pages

أدوات التصحيح

نظرًا لأن خادم MCP يتصل عبر stdio، فقد يكون التصحيح صعبًا نسبيًا. يوصي المشروع باستخدام MCP Inspector للتصحيح:

npm run inspector

سيوفر Inspector عنوان URL يمكن الوصول إليه في المتصفح لأدوات التصحيح.

ميزات المشروع

1. واجهة موحدة: يسهل هذا الخادم التفاعل مع مشاريع cosense/Scrapbox، مما يتيح للمستخدمين استرداد الصفحات وسردها والبحث عنها وإنشائها، مع دعم عمليات الاستعلام المختلفة والوصول الآمن إلى المشاريع الخاصة

2. الأمان: يدعم الوصول إلى المشاريع الخاصة عبر معرف الجلسة، مما يضمن أمان البيانات

3. تكوين مرن: يوفر العديد من خيارات متغيرات البيئة للتكيف مع سيناريوهات الاستخدام المختلفة

4. سهولة التطوير: يوفر إعادة بناء تلقائية في وضع التطوير وأدوات تصحيح مخصصة

سيناريوهات الاستخدام

• أتمتة إدارة المعرفة: دمج Scrapbox لتحقيق إدارة المعرفة والملاحظات التعاونية ووظائف قراءة وكتابة الصفحات لتطبيقات روبوتات الدردشة
• تحسين مساعد الذكاء الاصطناعي: تزويد تطبيقات الذكاء الاصطناعي بالقدرة على الوصول إلى قواعد المعرفة المنظمة
• تحسين استرجاع المحتوى: استرجاع محتوى Scrapbox والبحث فيه بكفاءة من خلال واجهة برمجة تطبيقات موحدة
• تكامل أدوات التعاون: دمج وظائف التعاون في Scrapbox في أدوات الذكاء الاصطناعي الأخرى

البنية التقنية

يعتمد هذا المشروع على بنية بروتوكول سياق النموذج، ويمكن للمطورين الكشف عن البيانات من خلال خادم MCP، أو إنشاء تطبيقات الذكاء الاصطناعي (عميل MCP). تم تطوير المشروع باستخدام Node.js و TypeScript، باتباع مواصفات بروتوكول MCP القياسية.

ملخص

scrapbox-cosense-mcp هو تطبيق خادم MCP كامل الميزات يوفر طريقة موحدة لتطبيقات الذكاء الاصطناعي للتفاعل مع قاعدة معارف Scrapbox. لا يدعم فقط عمليات الصفحة الأساسية، ولكنه يوفر أيضًا وظائف بحث قوية وقدرات وصول آمنة إلى المشاريع الخاصة، مما يجعله أداة مثالية لبناء أنظمة إدارة المعرفة الذكية.