خادم MCP

ما هو MCP؟

يتيح بروتوكول Model Context Protocol (MCP) لعملاء وكلاء الذكاء الاصطناعي — مثل Claude Desktop وCursor وأي تطبيق يدعم MCP — استدعاء الخدمات الخارجية كأدوات. تُشغّل Api.Airforce خادم MCP بعيدًا حتى تتمكن هذه العملاء من استخدام نماذجنا مباشرة.

نقطة النهاية والنقل

يتحدث الخادم بـ JSON-RPC 2.0 عبر Streamable HTTP على نقطة نهاية واحدة، إصدار البروتوكول 2025-06-18. تُعاد الاستجابات المتدفقة عند إرسال الترويسة Accept: text/event-stream.

POST https://api.airforce/mcp

المصادقة

أرسل مفتاح Api.Airforce API — أو رمز OAuth 2.0 من نوع bearer — في ترويسة Authorization. تُعيد الطلبات غير المصادق عليها 401 مع تحدي WWW-Authenticate يشير إلى بيانات OAuth الوصفية لدينا، حتى تتمكن العملاء المتوافقة من بدء تدفق OAuth تلقائيًا.

بالنسبة لرموز OAuth، النطاقات ذات الصلة هي profile (لـ get_balance) وchat (لـ chat_completion) وimages (لـ generate_image).

توصيل عميل

تقبل معظم العملاء عنوان URL لخادم MCP بعيد بالإضافة إلى رمز bearer. يبدو الإعداد النموذجي هكذا:

{
  "mcpServers": {
    "api-airforce": {
      "url": "https://api.airforce/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

يمكنك التحقق من الاتصال يدويًا عبر استدعاء JSON-RPC initialize:

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

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

استدعِ tools/list لاكتشافها أثناء التشغيل. تتوفر أربع أدوات:

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

الفوترة

تُحتسب chat_completion وgenerate_image على حسابك بنفس أسعار واجهة REST — لا يوجد تسعير منفصل لـ MCP. وlist_models وget_balance مجانيان.

الاكتشاف

تُنشر بطاقة خادم قابلة للقراءة آليًا من أجل الاكتشاف التلقائي:

https://api.airforce/.well-known/mcp/server-card.json