mcp-documentation-server MCP — حالات الاستخدام, التثبيت & عرض مباشر

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

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

محلي أولاً: لا توجد قاعدة بيانات سحابية أو استدعاءات خارجية إلا إذا فعّلت Gemini
تقسيم الأب والطفل يوازن بين الدقة والسياق
بحث مختلط بين النص الكامل والمتجهات
لوحة معلومات ويب مدمجة على المنفذ 3080 لتحميل السحب والإفلات
يدعم .txt و .md و .pdf جاهزة للاستخدام

عرض مباشر

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

documentation-server.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "documentation-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-documentation-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "documentation-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-documentation-server"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "documentation-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-documentation-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "documentation-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-documentation-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "documentation-server",
      "command": "npx",
      "args": [
        "-y",
        "mcp-documentation-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "documentation-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-documentation-server"
        ]
      }
    }
  }
}

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

claude mcp add documentation-server -- npx -y mcp-documentation-server

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

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

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

اجعل مستندات الإطار الجديد قابلة للاستعلام من قبل ذكاء اصطناعي

👤 المطورون الذين يعتمدون على مكتبة جديدة ⏱ ~20 min beginner

متى تستخدمه: المستندات الرسمية ضخمة؛ تريد من Claude أن يجيب مع اقتباسات مدعومة.

المتطلبات الأساسية

تم تثبيت mcp-documentation-server — npx -y @andrea9293/mcp-documentation-server

الخطوات

استيعب المستندات

حمّل ملفات .md للمستندات من المكتبة إلى لوحة المعلومات على http://localhost:3080.✓ تم النسخ

→ تمت معالجة الملفات في أجزاء
اطرح أسئلة محددة

ابحث في search_documents عن 'كيفية تكوين middleware' — أعطني أفضل 3 أجزاء مع مسارات المصدر.✓ تم النسخ

→ مقتطفات مقتبسة
اطلب تركيبًا مدعومًا

بناءً على تلك الأجزاء، اكتب أقل تكوين قابل للحياة لـ middleware في هذا الإطار.✓ تم النسخ

→ تكوين عامل مدعوم بأسطر المستندات المقتبسة

النتيجة: مساعد مستندات شخصي يستشهد بمصادره.

المزالق

ملفات PDF التي تحتوي على صور ممسوحة ضوئيًا لا تخضع للتعرف الضوئي على الأحرف — قم بـ OCR مسبقًا باستخدام أدوات مثل ocrmypdf قبل التحميل
مجموعات المستندات الضخمة بدون Gemini تعطي تضمينات صاخبة — مفتاح GEMINI_API_KEY الاختياري يفتح بحثًا دلاليًا أعلى جودة

اجمعها مع: filesystem

حول تصدير wiki داخلي إلى مصدر RAG

👤 الفرق التي لديها wikis توافقية لتصدير markdown ⏱ ~25 min beginner

متى تستخدمه: لقد قمت بتصدير محتوى Notion/Confluence كـ Markdown وتريد الوصول إلى AI.

الخطوات

الاستيعاب الكمي عبر process_uploads

process_uploads على ./wiki-export/ — معالجة كل .md.✓ تم النسخ

→ عدد المستندات لكل مجلد
بحث كامل النطاق

search_all_documents: 'deployment runbook' — أفضل 5.✓ تم النسخ

→ قائمة مرتبة

النتيجة: wiki محلي وخاص وقابل للبحث.

بناء مكتبة أبحاث شخصية

👤 الباحثون والطلاب ⏱ ~30 min beginner

متى تستخدمه: تقوم بتنزيل الأوراق وتريدها قابلة للاستعلام بدلاً من تكديسها في Downloads/

الخطوات

أسقط ملفات PDF

حمّل جميع ملفات PDF في ~/Papers/ إلى خادم التوثيق.✓ تم النسخ

→ تم تقسيم الأوراق وفهرستها
استعلم عبر الكل

search_documents: 'attention variants with lower quadratic cost' — أرجع المؤلفين والسنوات.✓ تم النسخ

→ مقتطفات مقتبسة

النتيجة: mini-perplexity محلي على مجموعة الأوراق الخاصة بك.

التركيبات

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

documentation-server + filesystem

أتمتة الاستيعاب من مجلد مراقب

في كل مرة تصل ملف PDF جديد إلى ~/Papers/Inbox، قم بـ process_uploads إلى خادم التوثيق.✓ تم النسخ

documentation-server + swarmvault

مقارنة: documentation-server هو استيعاب سريع؛ swarmvault ينشئ wiki منظم

استوعب ملفات PDF البحثية الخاصة بي في كلا النظامين؛ قارن جودة الاسترجاع في نفس الاستعلام.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
add_document	title, content, metadata?	الاستيعاب البرمجي	مجاني (التضمينات المحلية)
list_documents	(none)	انظر ما تم فهرسته	مجاني
get_document	id	استرجاع مستند معين	مجاني
delete_document	id	التقليم	مجاني
search_documents	query, top_k?	الاستعلام داخل مجموعة مستندات محددة	مجاني
search_all_documents	query, top_k?	استعلام RAG عام	مجاني
get_context_window	chunk_id	توسيع محاولة ضيقة إلى سياق أوسع	مجاني
search_documents_with_ai	query	تركيب إجابة لمرة واحدة	استدعاء Gemini (يحتاج مفتاح)
process_uploads	path?: str	استيراد دفعي من مجلد التحميلات	مجاني

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

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

حصة API: لا شيء إذا كان محليًا؛ استخدام Gemini إذا تم تعيين GEMINI_API_KEY
الرموز لكل استدعاء: البحث يرجع 500-3000 رمز اعتمادًا على top_k
التكلفة المالية: مجاني؛ Gemini يُدفع له في كل استدعاء إذا تم تفعيله
نصيحة: تخطَّ Gemini للعمل الاستكشافي — التضمينات المحلية كافية للبحث عن العناصر المعروفة.

الأمان

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

تخزين بيانات الاعتماد: GEMINI_API_KEY (اختياري) في env

نقل البيانات الخارجي: محلي فقط إلا إذا تم تفعيل Gemini؛ لوحة المعلومات على المنفذ 3080

لوحة المعلومات على :3080 لا توجد بها مصادقة — ربط على localhost فقط.
محتوى المستند يجلس في MCP_BASE_DIR كـ JSON؛ تعامل معه مثل أي بيانات محلية.

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

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

المنفذ 3080 قيد الاستخدام

اضبط متغير بيئة WEB_PORT على منفذ آخر.

تحقق: lsof -i :3080

خطأ في تحليل PDF

فشل ملفات PDF المحمية بكلمة مرور أو الممسوحة ضوئيًا. أزل كلمة المرور أو شغّل OCR أولاً.

تحقق: جرب ملف PDF عادي

البحث يرجع فارغًا

تحقق من المستندات المستوعبة: list_documents. إذا كانت فارغة، أعد تشغيل process_uploads.

تحقق: list_documents

البدائل

mcp-documentation-server مقابل البدائل

البديل	متى تستخدمها	المقايضة
swarmvault	تريد wiki منظم + رسم بياني للمعرفة، وليس البحث فقط	أثقل؛ إعداد أولي أكثر
Cloud RAG (Pinecone, Weaviate)	تحتاج إلى مشاركة الفريق والقياس	مدفوع؛ البيانات تغادر جهازك
llm-context.py	تريد السياق لكل مهمة وليس استرجاع المستندات المستمر	مشكلة مختلفة

mcp-documentation-server

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

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

اجعل مستندات الإطار الجديد قابلة للاستعلام من قبل ذكاء اصطناعي

المتطلبات الأساسية

الخطوات

المزالق

حول تصدير wiki داخلي إلى مصدر RAG

الخطوات

بناء مكتبة أبحاث شخصية

الخطوات

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

mcp-documentation-server مقابل البدائل

المزيد

الموارد