$_MCP خادم

خادم Model Context Protocol عام. اربط أي وكيل ذكاء اصطناعي متوافق مع MCP — كلود وCursor وغيرها — ودعه يستعلم مباشرةً عن بيانات shortage.life: الاحتياطيات الاستراتيجية والأسعار والسيناريوهات وملفات الدول والحوادث والمزيد.

[ 01 ]  $_ما هو MCP

بروتوكول سياق النموذج (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية. ويتيح shortage.life مجموعة بياناته على هيئة عشر أدوات MCP للقراءة فقط، عبر JSON-RPC 2.0. بلا مفتاح ولا حساب ولا تكلفة — البيانات نفسها المرخّصة بموجب CC-BY-4.0 كما في واجهة البرمجة العامة.

[ 02 ]  $_الاتصال

يتحدّث الخادم بـ JSON-RPC 2.0 عبر HTTP POST (إصدار MCP 2024-11-05). أضِفه إلى عميلك كخادم MCP بعيد.

claude mcp add --transport http \
  shortage-life https://mcp.shortage.life/mcp

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "shortage-life": {
      "url": "https://mcp.shortage.life/mcp"
    }
  }
}

[ 03 ]  $_الأدوات · 10 للقراءة فقط

تقابل كل أداة استعلامَ بيانات. تكتشفها الوكلاء عبر استدعاء tools/list وتنفّذها عبر tools/call.

[ 04 ]  $_مثال · استدعاءات JSON-RPC

اسرد الأدوات ثم نفّذ إحداها. لا حاجة إلى مصادقة.

curl -s https://mcp.shortage.life/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://mcp.shortage.life/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_price",
                 "arguments":{"commodity":"oil"}}}'

[ 05 ]  $_الاكتشاف

خادم MCP جزء من طبقة قابلية القراءة لوكلاء الذكاء الاصطناعي. وتعلن ملفاتُ الاكتشاف عنها بصيغة مقروءة آلياً.