لديك أسئلة أو مشكلات؟ اكتب في GitHub Discussions.

حوّل العملات واطّلع على أسعار الصرف الحالية أو التاريخية مباشرة من مساعدك الذكي، عبر خادم Model Context Protocol الرسمي. ويعود السجل اليومي إلى عام 1948.

أضف https://mcp.frankfurter.dev/ بوصفه خادم HTTP بعيدًا. لا حاجة إلى مفتاح API أو تسجيل.

ChatGPT

  1. افتح Settings، ثم Apps (أو Connectors).
  2. في أعلى الصفحة، انقر Advanced settings وفعّل Developer mode للسماح بالتطبيقات المخصصة.
  3. عد إلى القائمة الفرعية Apps، وانقر Create app (أو Create connector).
  4. أدخل عنوان نقطة النهاية: https://mcp.frankfurter.dev/.
  5. في قسم المصادقة (authentication)، اختر None.

Claude

في Claude Code:

claude mcp add frankfurter https://mcp.frankfurter.dev/

في Claude Desktop أو Claude.ai:

  1. افتح Settings، ثم Connectors.
  2. انقر Add custom connector.
  3. أدخل عنوان نقطة النهاية: https://mcp.frankfurter.dev/.
  4. انقر Add للإنهاء. بعد الاتصال، فعّل الموصّل في واجهة المحادثة.

عملاء آخرون

أضف ما يلي إلى إعدادات MCP لديك (Cursor وWindsurf وVS Code وغيرها):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

الأدوات

بعد الاتصال، يستطيع مساعدك استخدام هذه الأدوات:

convert
يحوّل مبلغًا بين عملتين. يُرجع افتراضيًا المبلغ المحوّل وعملته فقط. اضبط details: true ليُرجع أيضًا السعر وتاريخ سريانه والمصدر، إن اختير مصدر.
المعاملات:
  • amount (رقم، مطلوب): المبلغ المراد تحويله.
  • from (نص، مطلوب): رمز العملة أو الأصل المصدر (مثل USD أو XAU أو BTC).
  • to (نص، مطلوب): رمز العملة أو الأصل الهدف (مثل EUR).
  • date (نص، اختياري): تاريخ محدد YYYY-MM-DD للتحويل التاريخي.
  • provider (نص، اختياري): مفتاح مصدر (مثل ECB أو UST)، للحصول على السعر الذي تنشره مؤسسة واحدة بدلًا من السعر المدمج. والتاريخ الواقع ضمن فترة مصدر أسبوعي أو شهري أو فصلي يُرجع السعر الساري فيها.
  • details (قيمة منطقية، اختياري): يضمّن السعر وتاريخ سريانه والمصدر المختار (الافتراضي: false). التحويل بين العملة نفسها يُرجع السعر 1 والتاريخ null، دون مصدر.
get_rates
يعرض أسعار الصرف المرجعية.
المعاملات:
  • date (نص، اختياري): تاريخ السعر YYYY-MM-DD (الافتراضي هو الأحدث).
  • base (نص، اختياري): رمز العملة أو الأصل الأساسي (الافتراضي: EUR).
  • quotes (نص أو مصفوفة، اختياري): يحصر النتائج في رموز عملات أو أصول محددة.
  • provider (نص أو مصفوفة، اختياري): مفتاح مصدر واحد أو أكثر. وعلى العملة الأساسية للمصدر نفسه، تأتي الأرقام كما نُشرت، مع تاريخ سريانها.
لا يزال الاسم المستعار القديم providers مقبولًا. استخدم provider أو providers، لا كليهما.
list_currencies
يبحث عن رموز العملات والمعادن النفيسة والأصول المشفرة المدعومة وأسمائها، بما فيها العملات التاريخية. احذف المرشّح لعرض جميع الرموز.
المعاملات:
  • query (نص، اختياري): رمز أو جزء من اسم، دون تمييز لحالة الأحرف. والرمز المطابق تمامًا مقدَّم على المطابقات الجزئية.
list_providers
يبحث عن المصادر، مع المفتاح ونوع السعر والتواتر وتواريخ التغطية، لاختيار قيمة provider. والمصدر الذي ينشر عدة سلاسل يعرض أيضًا مجموعات بياناته؛ مرّر مفتاح مجموعة بيانات مثل NBP.B بوصفه provider لاختيار واحدة. تُجمع المرشّحات معًا ولا تميّز حالة الأحرف. احذفها لعرض جميع المصادر.
المعاملات:
  • query (نص، اختياري): مفتاح مصدر أو جزء من اسمه. والمفتاح المطابق تمامًا مقدَّم على المطابقات الجزئية.
  • country (نص، اختياري): رمز دولة من حرفين (مثل US).
  • currency (نص، اختياري): رمز عملة مدعومة، بما فيها العملة الأساسية للمصدر.

إذا احتجت إلى سلسلة زمنية أو نطاق تاريخي أو بيانات بالجملة، فاستخدم واجهة REST API.