كيفية استخدام SiteMCP وتحويل أي موقع إلى خادم MCP

في عالم الذكاء الاصطناعي المدفوع اليوم ، أصبحت القدرة على إدخال المعرفة الخارجية إلى نماذج اللغة الكبيرة (LLMs) ذات أهمية متزايدة. سواء كنت مطورًا أو منشئ محتوى أو متحمسًا للذكاء الاصطناعي ، فإن تمكين نماذجك من الوصول إلى معلومات محددة يمكن أن يحسن ردودها بشكل كبير. إليك SiteMCP ، أداة مبتكرة تسمح لك بتحويل أي موقع ويب تقريبًا إلى خادم نموذج سياق (MCP) ، مما يمكّن المساعدين الذكيين مثل كلود من الوصول مباشرة إلى محتوى الويب والإشارة إليه.

ما هو SiteMCP؟

SiteMCP هي أداة قوية تستخرج موقع ويب بالكامل وتحوله إلى خادم MCP. تم تطوير هذه الأداة من قبل ryoppippi ، وهي تسد الفجوة بين محتوى الويب ونماذج الذكاء الاصطناعي من خلال جعل المواقع قابلة للوصول من خلال إطار بروتوكول نموذج السياق. إنها في الأساس حل يمكّن LLMs من قراءة والإشارة إلى المواقع التي لا تدعم MCP بشكل طبيعي أو لم تقدم طرق تكامل محددة.

任意のサイトをMCP Serverに変えちゃうヤバいやつ作ったよ！https://t.co/MTYkdu1jjO pic.twitter.com/xHkb05eWF1
— ryoppippi (@ryoppippi) 7 أبريل 2025

حقوق النشر: تم إنشاء SiteMCP بواسطة ryoppippi. أشجعك على الاطلاع على مشروعه في GitHub على https://github.com/ryoppippi/sitemcp لدعم عمله ومتابعة أحدث الميزات والتطورات

يرجى الاطلاع على مستودع SiteMCP على GitHub

ما هو بروتوكول نموذج السياق (MCP)؟

قبل الغوص أعمق في SiteMCP ، دعنا نفهم ما هو MCP في الواقع. MCP هو اختصار لـ "بروتوكول نموذج السياق" ، وهو نظام يسمح للمساعدين الذكيين بالوصول إلى مصادر البيانات الخارجية. بعبارات بسيطة ، إنه بروتوكول يمكّنك من إخبار الذكاء الاصطناعي ، "يرجى قراءة هذا الموقع" أو "تحقق من هذا الملف" ، وأن يقوم الذكاء الاصطناعي باسترجاع ومعالجة تلك المعلومات بالفعل.

يعمل MCP كحلقة وصل بين نماذج الذكاء الاصطناعي ومصادر المعرفة الخارجية ، مما يجعل التفاعلات أكثر إطلاعًا وملاءمة للسياق. بدون MCP، سيقتصر المساعدون الذكيو على المعلومات التي تم تدريبهم عليها، مما قد يؤدي إلى عدم قدرتهم على الحصول على آخر التطورات أو المحتوى المحدد الذي ترغب في الإشارة إليه.

لماذا يعتبر SiteMCP مهمًا

يحل SiteMCP العديد من التحديات الحرجة:

الوصول إلى المعلومات غير المقدمة: العديد من المواقع لا تقدم خوادم MCP أو توافقًا مع أدوات الذكاء الاصطناعي. يتجاوز SiteMCP هذا القيد.
تقليل استهلاك الرموز: بدلاً من إدخال مواقع الويب بالكامل في موجه (مما يستهلك رموزًا ثمينة) ، يتيح SiteMCP للذكاء الاصطناعي الوصول فقط إلى ما يحتاجه عند الحاجة.
معلومات محدثة: الوصول إلى أحدث الوثائق، خاصة للتقنيات والمكتبات التي تتغير بسرعة.
قاعدة معرفة مخصصة: جعل مواقعك الشخصية أو الوثائق أو قواعد المعرفة متاحة للمساعدين الذكيين.

البدء مع SiteMCP

خيارات التثبيت

يقدم SiteMCP خيارات تثبيت مرنة حسب تفضيلاتك:

للاستخدام لمرة واحدة:

# اختر واحدة مما يلي:
bunx sitemcp
npx sitemcp
pnpx sitemcp

للتثبيت العالمي:

# اختر واحدة مما يلي:
bun i -g sitemcp
npm i -g sitemcp
pnpm i -g sitemcp

الاستخدام الأساسي

استخدام SiteMCP سهل للغاية. الأمر الأكثر بساطة يتبع هذا النمط:

sitemcp https://example.com

سيقوم هذا باستخراج الموقع بالكامل في example.com وإنشاء خادم MCP له. للحصول على أداء أفضل مع المواقع الأكبر حجمًا ، يمكنك ضبط تناسق الوصول:

sitemcp https://example.com --concurrency 10

خيارات الإعداد المتقدمة

يقدم SiteMCP العديد من خيارات التخصيص لضبط كيفية معالجة المواقع وتقديمها:

استراتيجية اسم الأداة

تحدد استراتيجية اسم الأداة كيفية إنشاء أسماء خوادم MCP. يتم تعيين ذلك باستخدام العلامة -t أو --tool-name-strategy:

# استخدم النطاق كاسم الأداة
sitemcp https://vite.dev -t domain

# استخدم النطاق الفرعي كاسم الأداة
sitemcp https://react-tweet.vercel.app/ -t subdomain

# استخدم مسار الصفحة كاسم الأداة (افتراضي)
sitemcp https://ryoppippi.github.io/vite-plugin-favicons/ -t pathname
# ينتج عنه: indexOfVitePluginFavicons / getDocumentOfVitePluginFavicons

مطابقة صفحات محددة

بالنسبة للمواقع الكبيرة ، قد ترغب في تقييد الصفحات التي يتم استخراجها. تتيح لك العلامة -m أو --match تحديد الأنماط:

sitemcp https://vite.dev -m "/guide/**" "/blog/**"

سيقوم هذا باستخراج الصفحات التي تطابق الأنماط المحددة فقط، مما يوفر وقت المعالجة والموارد. تتمتع المطابقة بدعم من micromatch، مما يوفر قدرات مطابقة أنماط قوية.

مختار المحتوى

يستخدم SiteMCP أداة قراءة Mozilla لاستخراج محتوى ذي مغزى من صفحات الويب. ومع ذلك ، في بعض الأحيان قد لا تلتقط هذه الاستخراجات التلقائية المحتوى الصحيح. في مثل هذه الحالات، يمكنك تحديد محدد CSS:

sitemcp https://vite.dev --content-selector ".content"

آلية التخزين المؤقت

يقوم SiteMCP بتخزين الصفحات المستخرجة في ~/.cache/sitemcp بشكل افتراضي، مما يعزز سرعة التشغيل اللاحق. إذا كنت بحاجة إلى محتوى جديد في كل مرة، يمكنك تعطيل التخزين المؤقت:

sitemcp https://example.com --no-cache

دمج SiteMCP مع عملاء MCP

تأتي القوة الحقيقية لـ SiteMCP عند دمجه مع عملاء الذكاء الاصطناعي المتوافقين مع MCP. دعنا نستكشف كيفية إعداد ذلك مع Claude Desktop ، مساعد الذكاء الاصطناعي الشهير:

تكوين Claude Desktop

لتكوين Claude Desktop لاستخدام خادم SiteMCP الخاص بك، أضف ما يلي إلى ملف التكوين الخاص بك:

{
  "mcpServers": {
    "daisy-ui": {
      "command": "npx",
      "args": [
        "-y",
        "sitemcp",
        "https://daisyui.com",
        "-m",
        "/components/**"
      ]
    }
  }
}

يخبر هذا التكوين Claude Desktop بإعداد خادم MCP يسمى "daisy-ui" يوفر الوصول إلى وثائق مكونات DaisyUI. عند إعادة تشغيل Claude Desktop، سيقوم تلقائيًا بإطلاق خادم SiteMCP عند الحاجة.

حالات الاستخدام العملية

الوصول إلى وثائق المكتبة

واحدة من أقوى استخدامات SiteMCP هي توفير وصول المساعدين الذكيين إلى وثائق المكتبة:

{
  "mcpServers": {
    "svelte": {
      "command": "npx",
      "args": [
        "-y",
        "sitemcp@latest",
        "https://svelte.dev",
        "-m",
        "/docs/**"
      ]
    }
  }
}

يمكّن هذا التكوين الذكاء الاصطناعي الخاص بك من الإشارة إلى أحدث وثائق Svelte ، مما يضمن أن تعكس اقتراحات الكود والتفسيرات أفضل الممارسات الحالية بدلاً من المعلومات القديمة التي قد يكون تعلمها الذكاء الاصطناعي أثناء التدريب.

دمج الموقع الشخصي

يمكنك أيضًا جعل موقعك الشخصي متاحًا للذكاء الاصطناعي:

{
  "mcpServers": {
    "my-blog": {
      "command": "npx",
      "args": [
        "-y",
        "sitemcp@latest",
        "https://yourblog.com"
      ]
    }
  }
}

يسمح هذا للذكاء الاصطناعي بالإشارة إلى أسلوب كتابتك والمقالات السابقة أو الوثائق الشخصية، مما يجعل ردودهم أكثر تناسبًا مع السياق الخاص بك.

فهم كيف يعمل SiteMCP

يعمل SiteMCP من خلال بنية خادم مزدوجة ذكية:

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

تسمح هذه الطريقة للذكاء الاصطناعي بفهم المعلومات المتاحة أولاً ثم استرجاع ما يحتاجه فقط بشكل انتقائي ، مما يقلل بشكل كبير من استخدام الرموز مقارنة بتوفير كل المعلومات دفعة واحدة.

عندما تكون صفحة معينة طويلة جدًا ، يقوم SiteMCP بتنفيذ الصفحات لضمان الوصول الموثوق ، حيث قد يواجه بعض نماذج الذكاء الاصطناعي صعوبة في التعامل مع مستندات كبيرة للغاية.

استكشاف المشكلات الشائعة

أسماء الأدوات الطويلة

واجه بعض المستخدمين مشكلات مع أسماء الأدوات التي تتجاوز 64 حرفًا في بعض عملاء MCP. وقد عالجت النسخة الأخيرة (v0.3.0 وما فوق) هذه المشكلة، ولكن إذا واجهت مشكلات مماثلة، يُنصح بالتحديث إلى أحدث إصدار.

أخطاء الاتصال بالخادم

إذا واجهت أخطاء JSONRPC مثل {"jsonrpc":"2.0","id":XX,"error":{"code":-32601,"message":"Method not found"}}، تأكد من أنك تستخدم أحدث إصدار من SiteMCP، والذي يشمل إصلاحات للتوافق مع عملاء MCP المتنوعين.

اعتبارات الأداء

بالنسبة للمواقع الكبيرة جدًا، ضع في اعتبارك استخدام معلمة المطابقة لتقييد الصفحات التي يتم استخراجها:

sitemcp https://large-documentation-site.com -m "/get-started/**" "/api/**"

يمكن أن يحسن هذا الأداء بشكل كبير ويقلل من استهلاك الموارد.

تطبيقات SiteMCP المتقدمة

إنشاء قواعد معرفة مخصصة

بجانب المواقع الموجودة، يمكنك استخدام SiteMCP لإنشاء قواعد معرفة مخصصة من خلال توجيهها إلى محتوى يتم تقديمه محليًا:

# أولاً قدم وثائقك المحلية
npx serve ./my-docs

# ثم في نافذة طرفية أخرى، أنشئ خادم MCP منه
sitemcp http://localhost:3000

دمج مصادر المعرفة المتعددة

يمكنك تكوين خوادم SiteMCP المتعددة في عميل MCP الخاص بك لتوفير وصول الذكاء الاصطناعي إلى مصادر معلومات متنوعة:

{
  "mcpServers": {
    "technical-docs": {
      "command": "npx",
      "args": ["-y", "sitemcp@latest", "https://docs.example.com"]
    },
    "company-blog": {
      "command": "npx",
      "args": ["-y", "sitemcp@latest", "https://blog.example.com"]
    }
  }
}

خاتمة

يقدم SiteMCP حلًا أنيقًا لأحد أكثر التحديات شيوعًا في تفاعلات الذكاء الاصطناعي: توفير معرفة خارجية محددة لنماذج الذكاء الاصطناعي. من خلال تحويل أي موقع ويب إلى خادم MCP، فإنه يسد الفجوة بين محتوى الويب وقدرات الذكاء الاصطناعي، مما يمكّن ردود الذكاء الاصطناعي من أن تكون أكثر استنارة ودقة وملاءمة للسياق.

سواء كنت مطورًا ترغب في تزويد الذكاء الاصطناعي الخاص بك بالوصول إلى وثائق محددة ، أو منشئ محتوى يرغب في أن يشير الذكاء الاصطناعي إلى عملك ، أو ببساطة متحمسًا للذكاء الاصطناعي يسعى لتوسيع ما يمكن لمساعدك القيام به ، يقدم SiteMCP طريقة مباشرة لتعزيز التعاون بين الذكاء الاصطناعي والبشر.

مع استمرار تطور مشهد الذكاء الاصطناعي ، ستصبح أدوات مثل SiteMCP التي تسهل تدفق المعلومات بين موارد الويب ونماذج الذكاء الاصطناعي أكثر قيمة. من خلال اتقان SiteMCP، أنت لا تتعلم أداة فحسب - بل تعتنق عصر جديد من تفاعل الذكاء الاصطناعي الذي يستفيد من المعرفة الهائلة المتاحة على الويب لجعل المساعدين الذكيين أكثر فائدة ودقة ووعيًا بالسياق.