خادم puremd MCP

ما وظيفة خادم “puremd” MCP؟

يُعد خادم puremd MCP (بروتوكول سياق النماذج) أداة قوية تربط المساعدين والوكلاء الذكاء الاصطناعي بمحتوى الويب من خلال العمل كجسر لتجاوز الحجب، والاستخلاص، والبحث. بالاعتماد على منصة pure.md ، يمكن للسكريبتات وواجهات البرمجة والتطبيقات والوكلاء الوصول إلى صفحات الويب بصيغة ماركداون ببساطة عن طريق إضافة البادئة pure.md/ لأي عنوان URL. تسمح هذه الطريقة بتجاوز اكتشاف الروبوتات، وعرض تطبيقات الويب أحادية الصفحة المعتمدة على جافاسكريبت، وتحويل مجموعة واسعة من التنسيقات (HTML، PDF، صور) إلى ماركداون. تضمن الاستجابات المخزنة مؤقتاً عالمياً وصولاً فعالاً ومتكرراً لنفس الموارد، مع تقليل الحمل على خوادم المصدر. يقوم خادم puremd-mcp بإرشاد عملاء MCP (مثل Cursor وWindsurf وClaude Desktop) حول كيفية استخدام هذه الميزات، مما يؤدي إلى فتح المحتوى وتمكين البحث المتقدم ضمن سير عمل تطوير الذكاء الاصطناعي.

قائمة القوالب البرمجية

لا توجد قوالب برمجية مذكورة صراحة في المستودع أو الوثائق.

قائمة الموارد

لا توجد موارد محددة (وفق تعريف MCP) مذكورة في المستودع أو الوثائق.

قائمة الأدوات

• unblock-url
  يستخلص ماركداون من صفحات الويب بدون حجب، مما يمكّن عملاء الذكاء الاصطناعي من الحصول على محتوى قابل للقراءة حتى من المواقع التي تحتوي على تدابير مكافحة الروبوتات.
• search-web
  يبحث في الويب عن استعلام معين ويجمع النتائج في مستند ماركداون واحد، موفراً ملخصاً للبحث لصالح الوكلاء والمستخدمين.

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

• تجاوز اكتشاف الروبوتات لاستخلاص الويب
  يمكّن الوكلاء ونماذج LLM من جلب المحتوى من مواقع عادة ما تحظر السكريبتات الآلية، عبر بنية pure.md لتجنب الاكتشاف.
• تحويل محتوى الويب إلى ماركداون
  يحوّل مجموعة كبيرة من موارد الويب (HTML، PDF، صور) إلى صيغة ماركداون، موحّداً المدخلات لمعالجة LLM والوكلاء لاحقاً.
• دمج البحث في الويب
  يمنح المساعدين الذكاء الاصطناعي القدرة على إجراء عمليات بحث والوصول إلى نتائج مركبة بصيغة ماركداون، وهو أمر أساسي للبحث والتلخيص وبناء السياق.
• تخزين مؤقت عالمي للمحتوى
  يقلل من الحمل على الخوادم ويضمن وصولاً أسرع للاستعلامات المتكررة من خلال استخدام تخزين مؤقت مشابه لشبكات CDN للموارد التي تم الوصول إليها سابقاً.
• إثراء سياق LLM بسلاسة
  يتيح للمطورين إثراء نافذة سياق LLM تلقائياً بمعلومات ويب حديثة وذات صلة، مما يعزز أداء تطبيقات الذكاء الاصطناعي القائمة على المعرفة.

كيفية إعداده

Windsurf

1. تأكد من تثبيت Node.js و npm.
2. أنشئ مفتاح PUREMD API في pure.md (اختياري لزيادة حدود الاستخدام).
3. عدّل ./codeium/windsurf/model_config.json.
4. أضف إدخال خادم MCP التالي:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. احفظ وأعد تشغيل Windsurf لتطبيق التغييرات.

Claude

1. تأكد من تثبيت Node.js و npm.
2. احصل على مفتاح PUREMD API (راجع pure.md ).
3. عدّل ~/Library/Application Support/Claude/claude_desktop_config.json.
4. أدخل الإعداد التالي:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. احفظ وأعد تشغيل Claude Desktop.

Cursor

1. ثبّت Node.js و npm.
2. سجّل وأنشئ مفتاح PUREMD API من pure.md .
3. عدّل ~/.cursor/mcp.json.
4. أضف إعداد خادم MCP التالي:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. احفظ وأعد تشغيل Cursor.

Cline

لا توجد تعليمات محددة لـ Cline في المستودع أو الوثائق.

تأمين مفاتيح API (متغيرات البيئة)

يجب حفظ مفاتيح API بشكل آمن باستخدام الحقل env في إعداد خادم MCP:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

كيفية استخدام MCP هذا داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP ضمن سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام لـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق من JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة والوصول إلى جميع وظائفه وقدراته. تذكّر تغيير “MCP-name” إلى اسم خادم MCP الخاص بك (مثل “github-mcp”، “weather-api”، إلخ) واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

استناداً إلى الوثائق المتوفرة، يُعد puremd-mcp خادماً عملياً وفعّالاً لـ MCP بوضوح في تجاوز حجب الويب والبحث. ومع ذلك، يفتقر إلى قوالب برمجية وتعريفات موارد، ولا يوجد ذكر لـ Roots أو دعم الاختيار العشوائي. بالنسبة للوصول العام للويب والبحث، يحصل على تقييم قوي لبساطته وفائدته الفورية.

تقييم MCP