انتقل إلى المحتوى

اختبارات Pine التاريخية من Claude وأي عميل MCP

مستضاف، بلا تثبيت

claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp

المستضاف: حصّة واحدة من 100 استدعاء أسبوعياً لكل IP، مشتركة بين backtest_pine وcheck_tradingview_parity.

Docker محلّي، على بياناتك أنت

docker run --rm -i -v "$PWD:/work" ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest

طريقة القياس

بلا Docker ولا تثبيت. مجاني وبلا مفتاح: حصّة مشتركة من 100 استدعاء أسبوعياً لكل IP لـ backtest_pine وcheck_tradingview_parity، تتجدّد الاثنين 00:00 بتوقيت UTC؛ بقية الأدوات لا تستهلك الحصّة. بيانات OHLCV للعملات الرقمية لآخر 365 يوماً من Binance وBybit وOKX وCoinbase. قد تُوقِف ميزانية الحوسبة الشهرية المشتركة لجميع المستخدمين المجانيين الاختبارات التاريخية وفحوص التطابق حتى الشهر التالي بتوقيت UTC. باقة مفتاح API (التاريخ الكامل وحدود أعلى) عبر قائمة الانتظار فقط.

مستضاف: تُرسَل شيفرة Pine المصدرية الخاصة بك إلى mcp.pineforge.dev لإجراء الاختبار التاريخي؛ وتُقدَّم بيانات OHLCV من مجموعة بياناتنا. ولا حاجة إلى أي ملفات محلّية. ولحساب عدد الجهات المختلفة التي تستدعي الخادم المستضاف، يُسجَّل عنوان IP لكل استدعاء أداة (ولـ IPv6، كتلة ‎/64) مع الأسبوع وعدد الاستدعاءات. وتُحذَف هذه السجلّات بعد 8 أسابيع؛ ولا يُحتفظ إلا بالإجماليات الأسبوعية دون عناوين. وحتى هذا التغيير، لم تُسجَّل بالعنوان إلا الاستدعاءات التي تُحتسَب على الحصّة الأسبوعية.

نقطة الوصول المستضافة هي mcp.pineforge.dev/mcp: يتّصل بها عملاء MCP عبر Streamable HTTP، وإذا فتحتها في المتصفّح ظهرت لك صفحة إعداد الخادم. وتتوفّر لوكلاء الذكاء الاصطناعي بطاقة خادم MCP وllms.txt وfacts.json، ويضمّ الأخير الأرقام الرئيسية في الموقع بصيغة قابلة للقراءة آلياً، مع تاريخ كل مجموعة منها ومصدرها.

إعداد العميل

يتطلّب Docker. اربط مجلّد عمل على المسار ‎/work، وأشِر إلى ملفات CSV عبر مساراتها بالصيغة ‎/work/...‎. بلا مفتاح API: فالمحرّك والمحوِّل مُضمَّنان في الصورة.

محلّياً: يجري التحويل والاختبار التاريخي داخل الحاوية، فتبقى شيفرة Pine المصدرية وبيانات OHLCV على جهازك، دون مفتاح API. والاتصالات الشبكية الوحيدة موجّهة إلى واجهة API العامة لدى Binance: التنزيلات التي تطلبها (fetch_binance_ohlcv وbinance_symbols)، وحجم التيك لسوق ما حين تحدّد رمزه، والشموع التي تجلبها أداة check_tradingview_parity حين لا تمرّر شموعك الخاصة.

Claude Code CLI

مستضاف، بلا تثبيت

claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp

Docker محلّي، على بياناتك أنت

claude mcp add pineforge-local \
  -- docker run --rm -i -v "$PWD:/work" \
  ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest

إعدادات JSON لـ Cursor وClaude Desktop وغيرهما

لكل عميل يقرأ إعداد mcpServers بصيغة JSON. يقرؤه Cursor من ‎.cursor/mcp.json في مشروعك، أو من ‎~/.cursor/mcp.json لجميع المشاريع. أمّا Claude Desktop فلا يقرأ من claude_desktop_config.json إلا الخوادم المحلّية (Settings ثم Developer ثم Edit Config)؛ لذا أضف الخادم المستضاف كموصل مخصّص بدلاً من ذلك (Customize ثم Connectors ثم Add custom connector). وفي مقتطف الخادم المحلّي، استبدل ‎/absolute/path/to/your/data بالمجلّد الذي يحتوي على ملفات CSV الخاصة بك.

مستضاف، بلا تثبيت

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

Docker محلّي، على بياناتك أنت

{
  "mcpServers": {
    "pineforge-local": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "/absolute/path/to/your/data:/work",
        "ghcr.io/pineforge-4pass/pineforge-backtest-mcp:latest"
      ]
    }
  }
}

متغيّرات البيئة

PINEFORGE_ALLOW_ANYWHEREالافتراضي 1
السماح بمسارات OHLCV خارج مجلّد العمل. صورة الحاوية تضبط هذا على 1.
PINEFORGE_DOCKER_TIMEOUT_MSالافتراضي 120000
إنهاء صارم (ms) لتشغيل المحرّك. الافتراضي دقيقتان.

11 أداة مستضافة و11 محلّية

على الخادمين كليهما

backtest_pine
تحويل وتصريف وتشغيل على البيانات المستضافة أو على ملف CSV الخاص بك. تُعيد التقرير؛ ومع التقارير الكبيرة يُعيد الخادم المحلّي الملخّص مباشرة ضمن الرد.
check_tradingview_parity
تقييم تطابق صفقات TradingView المُصدَّرة مع نتائج تشغيل السكربت نفسه على PineForge.
list_engine_params
عرض كل القيم البديلة لإعدادات الاستراتيجية وإعدادات بيئة التشغيل التي يقبلها الاختبار التاريخي. بلا أي عمليات إدخال أو إخراج.
engine_info
يُبلّغ عن المحرّك: الوضع، علامة التضمين، الإصدار.
list_coverage_topics
عرض جميع مواضيع التغطية في Pine v6، مع حالة كلٍّ منها في سطر واحد.
get_coverage_topic
عرض الميزات المدعومة وغير المدعومة في موضوع تغطية واحد.
check_pine_feature
التحقّق مما إذا كان معرّف محدّد في Pine مدعوماً.

على الخادم المستضاف فقط

list_symbols
سرد الرموز التي توفّر لها واجهة بيانات PineForge بيانات OHLCV في سوق واحد من أسواق العملات الرقمية المدعومة. تأتي الرموز من واجهة بيانات PineForge، التي تغطي أربع بورصات (Binance وBybit وOKX وCoinbase) مع أنواع أسواق فورية ودائمة USDT (Coinbase الفورية فقط)، وتُرشّح حسب query (جزء نصي فرعي غير حساس لحالة الأحرف). مجانًا.
check_quota
اعرض الاستدعاءات المتبقّية من الحصّة الأسبوعية المشتركة لـ backtest_pine وcheck_tradingview_parity (مستضاف).
join_waitlist
الانضمام إلى قائمة الانتظار لتعرف متى تُطلَق باقة مفتاح API: تاريخ OHLCV الكامل وحدود أعلى.
latest_news
آخر أخبار منتج PineForge، من الأحدث إلى الأقدم.

على الخادم المحلّي فقط

binance_symbols
عرض رموز Binance أو تصفيتها عبر الخادم المحلّي.
backtest_pine_grid
تحويل الاستراتيجية مرة واحدة، ثم تصريف وتشغيل كل تركيبة من المدخلات والقيم البديلة لإعدادات strategy()‎ التي تُدرجها، وترتيب النتائج.
transpile_pine
تحويل Pine v6 إلى وحدة ترجمة C++‎ دون تشغيلها.
fetch_binance_ohlcv
تنزيل شموع Binance من السوق الفورية أو من عقود USDT الدائمة إلى ملف CSV جاهز للاختبار التاريخي في مجلّد العمل، بحدّ أقصى 100,000 شمعة لكل عملية جلب.

WebMCP: أدوات لوكيل الذكاء الاصطناعي في متصفّحك

في المتصفّحات التي تدعم WebMCP، يضع pineforge.dev هذه الأدوات في متناول وكيل الذكاء الاصطناعي الذي تشغّله. وتأتي ردودها بالإنجليزية، مع روابط إلى صفحات الموقع.

get_evidence
أرقام التطابق أو لوحة النتائج أو مقارنة المحرّكات أو قياس السرعة، مع تواريخها وإصداراتها ومصادرها.
search_gallery
العثور على استراتيجيات المجموعة المرجعية المفتوحة بالاسم أو الفئة أو تقدير التطابق.
get_gallery_strategy
لاستراتيجية واحدة: تقديرها، ومدى تطابق صفقاتها، وملفاتها في المجموعة المرجعية.
search_site
البحث في الأسئلة الشائعة والمدوّنة، وفي صفحات المنهجية والمقارنة ومساعدي الذكاء الاصطناعي.
get_setup
إعداد خادمَي MCP، المستضاف والمحلّي، في مساعد الذكاء الاصطناعي لديك.
open_page
فتح صفحة من هذا الموقع في علامة التبويب الحالية.
read_chart
الرسم البياني في هذه الصفحة بالأرقام: جداوله ومصدره.
join_waitlist
تسجيل عنوان بريدك الإلكتروني لتصلك رسائل PineForge.

كما تنضمّ إليها أدوات الخادم المستضاف بأسمائها الأصلية، ويُشغّلها الخادم نفسه.