/ الدليل / الملعب / ref-tools-mcp
← كل الخوادم ↗ GitHub
● مجتمع ref-tools ⚡ فوري

ref-tools-mcp

بواسطة ref-tools · ref-tools/ref-tools-mcp

ساعد وكلاء البرمجة في العثور على المستندات الصحيحة بسرعة — مكتبات عامة وريبوهات خاصة وملفات PDF داخلية — دون هدر السياق على صفحات خاطئة.

ref-tools/ref-tools-mcp (من Ref) توفر أداتين: بحث موثق مركز عبر الويب العام وريبوهات GitHub والموارد الخاصة بك، بالإضافة إلى قارئ URL يعيد markdown. يتطلب REF_API_KEY.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

ref-tools.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ref-tools",
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "ref-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "ref-tools-mcp"
        ]
      }
    }
  }
}

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

claude mcp add ref-tools -- npx -y ref-tools-mcp

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

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

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

كيفية منع الوكيل من افتراع APIs المكتبات

👤 مستخدمو وكلاء البرمجة ⏱ ~10 min beginner

متى تستخدمه: يكتب الوكيل كودًا بثقة لا يطابق نسخة المكتبة الحالية.

المتطلبات الأساسية
  • Ref account + REF_API_KEY — قم بالتسجيل على ref.tools (أو أي عنوان تسجيل حالي لـ Ref)
الخطوات
  1. اطرح سؤالاً مرتبطًا بالمستندات
    استخدم ref_search_documentation للعثور على كيفية استخدام استعلامات Prisma raw SQL في v5، ثم اكتب مثالاً.✓ تم النسخ
    → نتائج البحث بـ URLs؛ الكود يستشهد بها
  2. تحقق
    استخدم ref_read_url على أفضل نتيجة للتأكد من شكل API.✓ تم النسخ
    → markdown نظيفة من صفحة المستند

النتيجة: كود يتجمع ضد نسخة المكتبة الفعلية.

المزالق
  • البحث يعيد مستندات قديمة لإصدار مُهمل v-X — أدرج الإصدار في الاستعلام: 'Prisma v5 raw SQL'
اجمعها مع: github

كيفية البحث في مستندات الهندسة الداخلية / ملفات PDF باستخدام وكيل

👤 فرق المنصة ذات الكتيبات الداخلية ⏱ ~15 min intermediate

متى تستخدمه: يحتاج الوكيل إلى اتباع الأنماط الخاصة بالشركة، وليس ما يقوله StackOverflow.

المتطلبات الأساسية
  • Ref private sources indexed — قم بتحميل ريبوهات/ملفات PDF إلى مساحة عمل Ref الخاصة بك (انظر مستندات Ref)
الخطوات
  1. حصر البحث في المصادر الخاصة
    ref_search_documentation 'نمط المصادقة الداخلي' مع المصادر الخاصة فقط.✓ تم النسخ
    → النتائج الداخلية فقط
  2. اقرأ كتاب التشغيل
    استخدم ref_read_url على أفضل نتيجة داخلية.✓ تم النسخ
    → نص نظيف من كتاب التشغيل

النتيجة: مخرجات متوافقة مع المعايير الداخلية.

المزالق
  • تصبح المستندات الداخلية قديمة — الوكيل لا يزال يستشهد بها — أخبر الوكيل بالتحقق من البيانات الوصفية 'آخر تحديث' وضع علامة على المحتوى القديم

كيفية جلب عناوين URLs عشوائية كـ markdown نظيفة

👤 أي شخص يقوم بالبحث والتلخيص ⏱ ~5 min beginner

متى تستخدمه: تريد نص المقالة بدون تنقل/إعلانات/فوضى JS

الخطوات
  1. اقرأ URL
    ref_read_url https://some-blog.com/post — أعطني markdown نظيفة.✓ تم النسخ
    → نص الجسم كـ markdown
  2. لخص
    أعطني الآن ملخصًا بـ 5 نقاط.✓ تم النسخ
    → ملخص

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

اجمعها مع: markdownify

التركيبات

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

ref-tools + github

أساس مراجعة PR مع استشهادات المستندات الرسمية

بالنسبة إلى هجرة Prisma في PR #1234، استخدم ref_search_documentation للتحقق من أن كل API يطابق مستندات v5، ثم أضف تعليقًا على PR.✓ تم النسخ
ref-tools + markdownify

دمج بحث المستندات من Ref مع markdownify لملفات PDF المحلية غير الموجودة في Ref

ابحث في Ref عن إرشادات المصادقة الداخلية لدينا، ثم استخدم markdownify على /specs/auth-v3.pdf الإضافي الذي لم يتم فهرسته بعد.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
ref_search_documentation query: str, sources?: str[] أساس سؤال المكتبة أو المستند الداخلي 1 Ref API call
ref_read_url url: str اسحب صفحة كـ markdown نظيفة 1 Ref API call

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

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

حصة API
لكل مستوى خطة Ref
الرموز لكل استدعاء
نتائج البحث: 500-2000 token. قراءة URL: يمكن أن تكون 5k-20k
التكلفة المالية
Ref هي خدمة مدفوعة (الطبقة المجانية متاحة)؛ تحقق من السعر الحالي
نصيحة
ابحث أولاً، ثم اقرأ فقط أفضل نتيجة — القراءات المتسلسلة مكلفة.

الأمان

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

الحد الأدنى من الصلاحيات: REF_API_KEY مخزنة في env
تخزين بيانات الاعتماد: REF_API_KEY متغير بيئة
نقل البيانات الخارجي: تذهب الاستعلامات إلى خدمة Ref؛ بدورها تضرب الويب العام والمصادر الخاصة المفهرسة لديك
لا تمنح أبدًا: لا تشارك مفتاح مساحة عملك على نطاق واسع؛ استخدم مفاتيح لكل مستخدم إذا كان Ref يدعمها

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

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

401 Unauthorized

REF_API_KEY مفقود أو غير صحيح.

تحقق: echo $REF_API_KEY
Search returns stale results

قد يكون إعادة فهرسة المصدر الخاص مؤجلاً؛ فرض إعادة الفهرسة من لوحة Ref.

ref_read_url returns empty

تحجب بعض المواقع التجريف. استخدم webpage-to-markdown عبر markdownify كحل بديل.

Quota exceeded

ترقية خطة Ref أو توزيع استخدام البحث.

البدائل

ref-tools-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Context7 MCPتريد استرجاع المستندات المكتبة العامة المجانيةلا توجد فهرسة مصدر خاص
Apple Docs MCP / pg-aiguideتهتم فقط بمستندات منصة محددةمحدود النطاق؛ ليس للأغراض العامة

المزيد

الموارد

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

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

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