خادم MCP العام

نقطة نهاية MCP العامة تتيح لأدوات الذكاء الاصطناعي قراءة نفس بيانات Esports Community العامة الظاهرة في الموقع. لا تحتاج إلى مفتاح.

هذه النقطة للقراءة فقط وتعرض بيانات عامة مخصصة لزوار الموقع.

صفحة الشرح:

https://esportscommunity.net/ar/docs/mcp

نقطة النهاية

الإنتاج:

https://esportscommunity.net/api/public-mcp

التطوير المحلي:

http://localhost:3000/api/public-mcp

الترويسات المطلوبة في كلا الإصدارين:

Content-Type: application/json
Accept: application/json, text/event-stream

لا تحتاج إلى مفتاح Bearer. يتم رفض طلبات JSON-RPC batch؛ أرسل طلب MCP واحدا في كل مرة.

إصدارات البروتوكول

يخدم العنوان نفسه كلا إصداري MCP، ويجيب حسب ما يعلنه الطلب، فلا يحتاج أي منهما إلى عنوان منفصل.

• الإصدار 2026-07-28 — بدون حالة. لا توجد مصافحة initialize ولا معرف جلسة.
• الإصدارات 2025-11-25 وما قبلها — عبر مصافحة initialize دون تغيير، وهي ما تستخدمه معظم العملاء حتى الآن، فلا يحتاج الإعداد أدناه إلى أي تعديل.

إيقاف مُعلن — الإزالة في 2026-11-23. أصبحت مصافحة initialize مهجورة اعتبارا من 2026-08-12 وسيتوقف تقديمها في 2026-11-23. لا شيء يتغير قبل هذا التاريخ: العملاء الذين يستخدمون المصافحة يعملون كما هم تماما. انقل عميلك إلى 2026-07-28 في أي وقت قبل ذلك. وبعد الإزالة يُجاب طلب المصافحة بخطأ الإصدار غير المدعوم مع ذكر ما تبقى مدعوما.

يعيد server/discover الإصدار 2026-07-28 فقط، وهو الإصدار الحديث القابل للتفاوض وليس قائمة كل ما تخدمه النقطة؛ فالعملاء القدامى لا يستدعونه أصلا بل يبدأون بـinitialize.

طلب الإصدار 2026-07-28 ينسخ ثلاث قيم من الجسم إلى الترويسات ويكرر رقم الإصدار داخل params._meta:

POST /api/public-mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: list_games

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_games",
    "arguments": { "locale": "ar" },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": { "name": "YourClient", "version": "1.0.0" },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

ترويسة Mcp-Name مطلوبة مع tools/call فقط ويجب أن تطابق params.name. أي ترويسة تخالف الجسم تُرفض بالخطأ -32020، وأي إصدار غير مدعوم يُرفض بالخطأ -32022 الذي يذكر ما تدعمه هذه النقطة.

كل نتيجة في الإصدار 2026-07-28 تحمل resultType: "complete". كما تحمل tools/list وserver/discover الحقلين ttlMs وcacheScope: هذه النقطة تعيد الأدوات نفسها لكل المستخدمين، لذا قائمتها cacheScope: "public" ويمكن للذاكرات المشتركة تخزينها.

الأدوات

• get_site_overview: يعرض أعداد الموقع والبوت، وقد تتضمن المكالمات الإدارية سياقا من لوحة التحكم حسب الصلاحيات.
• list_games: يعرض دليل الألعاب العام حسب اللغة.
• search_news: يبحث في الأخبار المنشورة للعامة أو في أخبار الإدارة الظاهرة ضمن نطاق المفتاح.
• get_tournament_status: يعرض المباريات والترتيب لبطولة واحدة متتبعة.
• list_tournaments: يعرض ملخصات البطولات العامة النشطة.
• get_ewc_club_summary: يعرض نقاط أندية EWC والألعاب المتأهلة والانتصارات وبيانات المناطق.
• get_ewc_club_standings: يعرض ترتيب بطولة أندية EWC الرسمي من آخر نسخة محفوظة.
• list_co_streams: يعرض مجموعات البثوث المشتركة العامة مع المباشر أولا.
• search_teams: يبحث في دليل الفرق العام باستخدام حقول عامة آمنة.
• search_players: يبحث في دليل اللاعبين العام باستخدام حقول عامة آمنة.
• get_public_ewc_leaderboard: يعرض لوحة توقعات EWC العامة الحالية.

أمثلة على الأسئلة

• “اعرض آخر أخبار Valorant في EWC مع روابط الموقع.”
• “ما الأندية المتصدرة في ترتيب بطولة أندية EWC؟”
• “اعرض لوحة ترتيب توقعات مجتمع EWC.”
• “ابحث عن Team Falcons واعرض بيانات ملفه العام.”

ترتيب بطولة الأندية وترتيب توقعات المجتمع مجموعتا بيانات منفصلتان ولكل منهما أداتها.

إعداد العميل

جرّبها من الطرفية أولا، دون تثبيت أو إعداد:

uvx mcp-explorer list https://esportscommunity.net/api/public-mcp
uvx mcp-explorer call https://esportscommunity.net/api/public-mcp search_teams -a query Falcons

والأمر uvx mcp-explorer doctor <url> يبيّن ما إذا كان إصدارا البروتوكول يعملان معا بسلامة.

استخدم إعداد Streamable HTTP MCP الأصلي عندما يدعمه العميل.

للعملاء الذين يدعمون stdio فقط، استخدم mcp-remote:

{
  "mcpServers": {
    "esports-community": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://esportscommunity.net/api/public-mcp"
      ]
    }
  }
}

لإعداد Codex عبر config.toml باستخدام stdio:

[mcp_servers.esports_community_public]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://esportscommunity.net/api/public-mcp",
]

للعملاء الذين يدعمون Streamable HTTP مباشرة:

[mcp_servers.esports_community_public]
enabled = true
url = "https://esportscommunity.net/api/public-mcp"

أعد تشغيل عميل MCP بعد تغيير الإعدادات.

ملاحظات الأمان

• هذه النقطة عامة وللقراءة فقط.
• طلبات المتصفح يتم التحقق من Origin لها.
• الطلبات محددة المعدل حسب عنوان IP الموثوق من الطرف. عند عدم وجود ترويسة IP موثوقة، تشترك الطلبات في حاوية معدل واحدة.
• تقتصر الاستجابات على حقول الموقع العامة.