أسعار الصرف في Cursor

أضف خادم MCP من exchangerate.dev إلى Cursor ليتمكن المساعد من البحث عن أسعار العملات وتحويل المبالغ. يعمل الخادم المستضاف دون مفتاح، بأسعار متأخرة 15 دقيقة. تحصل الخطط المدفوعة على أسعار لحظية عبر نقطة الاتصال نفسها.

إضافة الخادم المستضاف

احفظ الإعداد التالي في ~/.cursor/mcp.json لجميع المشاريع، أو في .cursor/mcp.json داخل جذر مشروع.

يوضع الإدخال ضمن mcpServers ويستخدم url للاتصال عبر Streamable HTTP بعنوان https://api.exchangerate.dev/v1/mcp/. أبقِ الشرطة المائلة الأخيرة. لا يتطلب الاتصال مفتاح API. بعد حفظ الملف وإعادة تحميل إعدادات MCP في Cursor أو إعادة تشغيله، يظهر الخادم ضمن أدوات MCP.

{  "mcpServers": {    "exchangerate-dev": {      "url": "https://api.exchangerate.dev/v1/mcp/"    }  }}

استخدام حصتك الخاصة

استبدل YOUR_API_KEY في الإعداد التالي بمفتاح API الخاص بك، ثم احفظ الملف وأعد تحميل إعدادات MCP في Cursor أو أعد تشغيل Cursor.

يضيف الإعداد Authorization: Bearer YOUR_API_KEY عبر headers. يمنحك مفتاحك حصة خطتك وحدودها. تشمل Free عدد 5,000 طلب شهريا و10 طلبات في الدقيقة. تشمل كل خطة الوصول إلى MCP، ومنها Free؛ وأسعار Free متأخرة 15 دقيقة.

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

تشغيل الجسر المحلي

ثبّت Node.js 20 أو أحدث، ثم استخدم الإعداد التالي بمفتاح API الخاص بك لتشغيل الجسر المحلي بدلا من الاتصال المستضاف.

يستخدم الإدخال المحلي command وargs وenv. يشغّل جسر npm عبر npx ويضبط EXCHANGERATE_API_KEY في البيئة. يتطلب الجسر مفتاح API. احفظ الملف وأعد تحميل إعدادات MCP في Cursor أو أعد تشغيل Cursor.

{  "mcpServers": {    "exchangerate-dev": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/exchangerate-mcp"      ],      "env": {        "EXCHANGERATE_API_KEY": "YOUR_API_KEY"      }    }  }}

التحقق من الأدوات وطلب سعر

تحقق من ظهور الأدوات الـ9 في Cursor، ثم اسأل «كم يساوي 100 يورو بالين الياباني الآن؟».

تجيب convert عن السؤال باستخدام from وto وamount. اسأل «ما سعر USD مقابل IDR في 1 سبتمبر؟» للبحث عبر get_range، أو «ما العملات التي يمكنك البحث عنها؟» عبر list_currencies.

تأخذ get_rate المعاملين base وquote لأحدث سعر. تسترجع get_range أسعارا ضمن نطاق زمني. تعيد get_usd_index مؤشر USD محسوبا بشكل مستقل، وتبحث search_docs في التوثيق.

تسرد list_official_rate_tables جداول أسعار تنشرها الجهات الحكومية، وتسترجع get_official_rate الأسعار التي تنشرها هذه الجهات. تفتح الأداة التاسعة، start_checkout، صفحة الدفع لخطة بعد تأكيد المستخدم فقط.

قراءة السعر ووقته

يمكن لـ Cursor قراءة الأرقام المُعادة وسياقها: source وmarket_session وdata_updated_at. اطلب من المساعد ذكر الوقت مع السعر.

تتضمن إجابة التحويل السعر والمبلغ المحوّل وعلامة عندما يكون السعر مشتقا عبر USD. تتضمن الإجابات تنبيها بأن الأسعار استرشادية ولا تصلح للتسوية أو التداول.

إصلاح أخطاء الاتصال

تحقق من صحة JSON في mcp.json إذا لم تظهر الأدوات. الفاصلة الزائدة في النهاية سبب شائع.

يعني HTTP 401 أن المفتاح في الترويسة خاطئ. ويعني HTTP 429 بلوغ حد الدقيقة أو الحصة الشهرية؛ انتظر موعد إعادة المحاولة.