/ الدليل / الملعب / JDocMunch MCP
● مجتمع jgravelle ⚡ فوري

JDocMunch MCP

بواسطة jgravelle · jgravelle/jdocmunch-mcp

استرجاع توثيق لا يُغرق سياقك — فهرس أقسام منظّم يتيح لـ Claude سحب القسم الذي يحتاجه فقط.

JDocMunch خادم MCP للتوثيق محسَّن لكفاءة tokens. يُفهرِس مسبقًا التوثيق في شجرة أقسام قابلة للتنقل (فهرس المحتويات + مراسي)، حتى يتمكن Claude من سحب قسم واحد ومتابعة المراجع المتقاطعة دون تفريغ 50KB من المواد المرجعية غير ذات الصلة. مصمم لمشكلة 'أنا أقرأ توثيق AWS SDK وClaude يستمر في جلب الصفحة بالكامل'.

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

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

عرض مباشر

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

jdocmunch-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcp

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

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

استخدامات عملية: JDocMunch MCP

سحب قسم مرجع API الذي تحتاجه فقط من موقع توثيق ضخم

👤 المطورون الذين يعملون مع SDKs السحابية ⏱ ~10 min beginner

متى تستخدمه: توثيق AWS SDK يمتد 200 صفحة وClaude يريد جلبها كلها.

المتطلبات الأساسية
  • URL التوثيق أو شجرة توثيق محلية — الاستدعاء الأول: افهرس التوثيق؛ الاستدعاءات التالية تضرب ذاكرة التخزين المؤقت
الخطوات
  1. الفهرسة
    Use jdocmunch. Index the AWS S3 SDK docs at the URL. Show me top-level sections.✓ تم النسخ
    → شجرة فهرس المحتويات مُعادة، لا محتوى كامل بعد
  2. التعمق
    Show only the section on multipart upload — code samples included, intro skipped.✓ تم النسخ
    → محتوى القسم المستهدف
  3. المتابعة
    Now follow the link to 'Aborting incomplete uploads' from that section.✓ تم النسخ
    → القسم المرتبط مسحوب

النتيجة: إجابة في 2k token بدلًا من 80k.

المزالق
  • بنية التوثيق تحتوي مراسي غريبة (PDF فقط) — حوّل إلى Markdown أولًا؛ jdocmunch يحلل Markdown بشكل أفضل
اجمعها مع: filesystem

مقارنة أقسام توثيق API عبر إصدارَي SDK

👤 المطورون الذين يُحدّثون التبعيات ⏱ ~20 min intermediate

متى تستخدمه: تنتقل من v3 إلى v4؛ تريد diff دقيق لما تغيّر.

الخطوات
  1. فهرسة كليهما
    Index doc-v3 and doc-v4. List sections that exist only in v4 or have changed.✓ تم النسخ
    → قائمة diff من الأقسام
  2. التعمق في ما تغيّر
    Show changes in the 'Authentication' section between v3 and v4.✓ تم النسخ
    → diff لكل قسم

النتيجة: دليل ترحيل مبني من التوثيق نفسه.

المزالق
  • معرّفات الأقسام تتغير بين الإصدارات — طابق بنص العنوان بدلًا من المرساة

التركيبات

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

jdocmunch-mcp + filesystem

حفظ الأقسام المُسترجَعة في ملاحظات المشروع

Pull the multipart-upload section and save it to /docs/notes/s3-multipart.md.✓ تم النسخ
jdocmunch-mcp + git-mcp-idosal

مطابقة التوثيق مع كود المصدر الحقيقي

Read the doc section, then GitMCP the actual SDK source for that method.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
index url_or_path المرة الأولى على مجموعة توثيق 1 fetch + parse
list_sections doc_id, depth? تنقل فهرس المحتويات free (cached)
get_section doc_id, section_path سحب قسم واحد free (cached)
follow_link doc_id, from_section, link_target متابعة المراجع المتقاطعة free (cached)

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

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

حصة API
وفق سياسة robots.txt للمضيف
الرموز لكل استدعاء
100–800 مع الاسترجاع المنظّم
التكلفة المالية
مجاني
نصيحة
افهرس مرة واحدة، استعلم كثيرًا — ذاكرة التخزين تجعل المتابعات رخيصة

الأمان

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

الحد الأدنى من الصلاحيات: Outbound HTTP for indexing
تخزين بيانات الاعتماد: لا شيء للتوثيق العام
نقل البيانات الخارجي: مضيف التوثيق الذي تفهرسه
لا تمنح أبدًا: Indexing of private internal docs without auth control

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

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

Index parse fails on JS-heavy doc site

بعض المواقع تحتاج متصفحًا headless؛ تحقق من وجود تصدير ثابت

Sections missing after re-index

بنية التوثيق تغيّرت؛ امسح ذاكرة التخزين وأعد الفهرسة

uvx can't find binary

مشكلة PATH تحت عميل MCP؛ استخدم uvx jdocmunch-mcp صريحًا

البدائل

JDocMunch MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Context7توثيق مكتبات منسّقة — كتالوج معروفمحدود بالمكتبات المُفهرَسة
GitMCPمستودع كتوثيق (README + /docs)GitMCP لا يُفهرس بنيويًا مواقع التوثيق الكبيرة

المزيد

الموارد

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

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

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