MCP Server

نظرة عامة

يُتيح خادم Web2MD MCP استخدام Web2MD كمجموعة أدوات يمكن لمساعدات AI استدعاءها مباشرة، باستخدام Model Context Protocol (MCP) — وهو معيار مفتوح لربط نماذج AI بالأدوات ومصادر البيانات الخارجية. بعد الإعداد، يمكنك أن تطلب من Claude أو Cursor أو Windsurf تحويل الصفحات، أو البحث في سجل تحويلاتك، أو استرجاع Markdown المحفوظ دون مغادرة المحادثة.

يتطلب خادم MCP مفتاح API لـ Web2MD (خطة PRO). أنشئ واحدًا من لوحة التحكم.

الأدوات المتاحة

يوفر خادم MCP ثلاث أدوات:

الأداة	الوصف
`convert_url`	تحويل أي رابط إلى Markdown نظيف
`semantic_search`	البحث في تحويلاتك المحفوظة بلغة طبيعية
`get_conversion`	استرجاع محتوى Markdown الكامل لتحويل محفوظ عبر المُعرِّف (ID)

convert_url

يجلب رابطًا ويُرجع محتوى الصفحة كـ Markdown. يدعم نفس خيارات التحويل المتوفرة في REST API. مثال على طلب: “حوّل هذا الرابط إلى markdown: https://docs.example.com/getting-started”

semantic_search

يبحث في جميع تحويلاتك المحفوظة سابقًا باستخدام استعلام بلغة طبيعية. يُرجع قائمة بالتحويلات المطابقة مع العناوين والروابط ودرجات الصلة. مثال على طلب: “ابحث في صفحاتي المحفوظة عن مقالات حول فهرسة قواعد البيانات”

get_conversion

يسترجع محتوى Markdown الكامل لتحويل محفوظ محدد عبر مُعرِّفه (ID). مفيد لسحب مستند كامل إلى السياق بعد العثور عليه باستخدام semantic_search. مثال على طلب: “احصل على المحتوى الكامل للتحويل abc123”

الإعداد

Claude Desktop
Cursor
Windsurf

افتح ملف إعدادات Claude Desktop:

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

أضف إدخال web2md ضمن mcpServers:

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["web2md-mcp"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

أعد تشغيل Claude Desktop. يجب أن تظهر أدوات Web2MD في قائمة اختيار الأدوات.

افتح ملف إعدادات MCP الخاص بـ Cursor في ~/.cursor/mcp.json وأضف:

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["web2md-mcp"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

أعد تشغيل Cursor لتحميل الخادم الجديد.

افتح ملف إعدادات MCP الخاص بـ Windsurf في ~/.windsurf/mcp.json وأضف:

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["web2md-mcp"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

أعد تشغيل Windsurf لتحميل الخادم الجديد.

أمثلة على الاستخدام

بعد تشغيل خادم MCP، يمكنك استخدام اللغة الطبيعية في مساعد AI الخاص بك:

تحويل صفحة إلى Markdown

أنت: حوّل هذا الرابط إلى markdown: https://react.dev/learn/thinking-in-reactالمساعد: (يستدعي convert_url) إليك Markdown المحوَّل لصفحة “Thinking in React”…

البحث في التحويلات المحفوظة

أنت: ابحث في صفحاتي المحفوظة عن أي شيء متعلق بالمصادقة (authentication)المساعد: (يستدعي semantic_search) وجدت 3 تحويلات محفوظة متعلقة بالمصادقة:

“OAuth 2.0 Guide” — محفوظ منذ يومين
“JWT Best Practices” — محفوظ الأسبوع الماضي
…

استرجاع تحويل كامل

أنت: احصل على المحتوى الكامل للتحويل abc123المساعد: (يستدعي get_conversion) إليك محتوى Markdown الكامل…

اجمع بين الأدوات في محادثة واحدة. على سبيل المثال: “ابحث في تحويلاتي عن وثائق React، ثم احصل على المحتوى الكامل لأحدثها.”

استكشاف الأخطاء وإصلاحها

الأدوات لا تظهر بعد الإعداد

تأكد من أنك أعدت تشغيل التطبيق بعد تعديل ملف الإعدادات. تحقق من أن الأمر npx web2md-mcp يعمل بنجاح في الطرفية (terminal).

أخطاء المصادقة

تحقق مرة أخرى من أن WEB2MD_API_KEY صحيح وأن اشتراك PRO الخاص بك نشط. يمكنك التحقق من مفتاحك على صفحة مفاتيح API.

فشل npx في تحديد موقع الحزمة

جرّب تثبيت الحزمة عالميًا أولًا: npm install -g web2md-mcp، ثم غيّر command إلى web2md-mcp واحذف حقل args.

البدء

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

متقدم

الخطط

نظرة عامة

الأدوات المتاحة

convert_url

semantic_search

get_conversion

الإعداد

أمثلة على الاستخدام

استكشاف الأخطاء وإصلاحها

​نظرة عامة

​الأدوات المتاحة

​convert_url

​semantic_search

​get_conversion

​الإعداد

​أمثلة على الاستخدام

​استكشاف الأخطاء وإصلاحها

نظرة عامة

الأدوات المتاحة

convert_url

semantic_search

get_conversion

الإعداد

أمثلة على الاستخدام

استكشاف الأخطاء وإصلاحها