$_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 بعيد.

endpointhttps://mcp.shortage.life/mcp

transportJSON-RPC 2.0 · HTTP POST

protocolMCP 2024-11-05

authnone — public, no key

licenseCC-BY-4.0

// Claude Code · Claude Desktop

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

// Cursor

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

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

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

tool	params	returns
get_reserve	commodity, country	الاحتياطي الاستراتيجي الحالي لسلعة في دولة ما.
get_price	commodity	السعر الفوري الحالي لسلعة.
compare_countries	commodity, countries[]	يقارن الاحتياطيات الاستراتيجية لسلعة بين عدة دول.
list_scenarios	status?	يسرد سيناريوهات النقص الاستشرافية، قابلة للتصفية حسب الحالة.
search_briefings	query, lang?	بحث بالكلمات المفتاحية في الموجزات التحريرية المنشورة.
get_country_profile	iso	ملف الدولة الكامل — مؤشر الإجهاد والمنطقة والاحتياطيات.
list_incidents	since?, type?	حوادث جيوسياسية على البنية التحتية للطاقة، منذ تاريخ اختياري.
list_market_statements	since?	تصريحات سياسية قد تحرّك الأسواق، منذ تاريخ اختياري.
list_bankruptcies	status?	بيانات إفلاسات الشركات حسب الدولة.
get_food_prices	—	الأسعار الحالية للسلع الغذائية وسلاسلها الأسبوعية.

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

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

// tools/list

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

// tools/call

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 جزء من طبقة قابلية القراءة لوكلاء الذكاء الاصطناعي. وتعلن ملفاتُ الاكتشاف عنها بصيغة مقروءة آلياً.

/.well-known/agents.json — capability manifest /.well-known/agent-card.json — A2A skills /openapi.json — OpenAPI 3.1 spec for the REST API /llms.txt — curated index for AI systems /api-docs — the public REST API documentation

// node

// $_ exec

// readout · live