Frankfurter MCP
لديك أسئلة أو مشكلات؟ اكتب في GitHub Discussions.
حوّل العملات واطّلع على أسعار الصرف الحالية أو التاريخية مباشرة من مساعدك الذكي، عبر خادم Model Context Protocol الرسمي. ويعود السجل اليومي إلى عام 1948.
أضف https://mcp.frankfurter.dev/ بوصفه خادم HTTP بعيدًا.
لا حاجة إلى مفتاح API أو تسجيل.
ChatGPT
- افتح Settings، ثم Apps (أو Connectors).
- في أعلى الصفحة، انقر Advanced settings وفعّل Developer mode للسماح بالتطبيقات المخصصة.
- عد إلى القائمة الفرعية Apps، وانقر Create app (أو Create connector).
- أدخل عنوان نقطة النهاية:
https://mcp.frankfurter.dev/. - في قسم المصادقة (authentication)، اختر None.
Claude
في Claude Code:
claude mcp add frankfurter https://mcp.frankfurter.dev/
في Claude Desktop أو Claude.ai:
- افتح Settings، ثم Connectors.
- انقر Add custom connector.
- أدخل عنوان نقطة النهاية:
https://mcp.frankfurter.dev/. - انقر 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.