1. ما هو MCP؟
MCP (Model Context Protocol) هو معيار مفتوح يتيح لمساعد الذكاء الاصطناعي استدعاء أدوات خارجية. يوفّر خادم سهمك MCP لمساعدك هذه الأدوات للتعامل مع بيانات تداول:
| الأداة | الغرض |
|---|---|
| get_quote | سعر شركة واحدة وتفاصيل تغيّره |
| get_quotes | مقارنة أسعار عدة شركات في طلب واحد |
| companies_list | البحث عن الرموز بالاسم أو الرمز عبر search, market, limit، وoffset |
| get_market_summary | ملخص أداء المؤشر اليوم |
| get_market_movers | أعلى الرابحين أو الخاسرين أو الأكثر نشاطاً، مع حقول ثابتة type, index, count، وitems |
| get_sectors | أداء القطاعات مع حقول ثابتة index, count، وitems |
| get_company | ملف الشركة وأبرز بياناتها الأساسية |
| get_historical | الأسعار التاريخية بنمط OHLCV (1d, 1w, 1m, 30m, 60m؛ وتسري عليها حدود الباقة والنطاق الزمني) |
| get_financials | القوائم المالية للشركة ومؤشراتها |
| get_dividends | عرض سجل التوزيعات وتفاصيل الدفعات |
ملاحظة: get_financials و get_dividends تتطلبان عادةً باقة Starter أو أعلى.
اشتراكك واحد في كل الحالات
سواء أضفت سهمك إلى ChatGPT أو Claude.ai، أو ثبّت الخادم على جهازك لـClaude Desktop وCursor، يُستخدم حساب المطوّر نفسه في سهمك، مع الحد اليومي نفسه وصلاحيات باقتك الحالية.
- الباقة: الباقة المجانية أو Starter أو Pro أو Business أو Enterprise التي لديك الآن.
- الصلاحيات: ما تسمح به باقتك ومفتاح API. البيانات اللحظية تتوفر فقط إذا كانت باقتك تشملها.
- حد الطلبات: كل استدعاء لأداة يُحسب من طلباتك اليومية في سهمك.
2. ربط سهمك بـChatGPT
سهمك مدرج في دليل إضافات ChatGPT. أضفه من الصفحة العامة.
يلزمك حساب مطوّر في سهمك ومفتاح API. أنشئ حساباً، أو افتح مفاتيح API إن كان لديك حساب.
أضف سهمك إلى ChatGPT- افتح صفحة سهمك في دليل إضافات ChatGPT.
- أضف سهمك أو اربطه.
- سجّل الدخول إلى سهمك.
- اختر مفتاح API ثم اسمح بالوصول. تمر الطلبات عبر هذا المفتاح وباقتك الحالية.
- ابدأ محادثة واختر @SAHMK.
مثال:
ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟
3. ربط سهمك بـClaude
سهمك مدرج في دليل Claude. أضفه من الصفحة العامة.
يلزمك حساب مطوّر في سهمك ومفتاح API. أنشئ حساباً، أو افتح مفاتيح API إن كان لديك حساب.
أضف سهمك إلى Claude- افتح صفحة سهمك في دليل Claude.
- سجّل الدخول إلى Claude ثم أضف سهمك.
- سجّل الدخول إلى سهمك.
- اختر مفتاح API ثم اسمح بالوصول. تمر الطلبات عبر هذا المفتاح وباقتك الحالية.
- في المحادثة، يستخدم Claude أدوات سهمك تلقائياً عند الحاجة.
مثال:
ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟
4. التثبيت على جهازك لـClaude Desktop وCursor
في Claude Desktop وCursor يعمل خادم سهمك MCP على جهازك عبر الحزمة الرسمية من PyPI. وهنا أيضاً يُستخدم مفتاح API واشتراكك الحالي، وكل استدعاء لأداة يُحسب من حدّك اليومي نفسه.
احصل على مفتاح API
تحتاج إلى مفتاح API من سهمك. احصل على مفتاحك المجاني عبر التسجيل هنا.
يبدأ المفتاح عادةً بـ shmk_live_ أو shmk_test_.
التثبيت
ثبّت خادم MCP من PyPI:
pip install -U sahmk-mcpإذا رفضت الأدوات معاملات أحدث، حدّث الحزمة عبر pip install -U sahmk-mcp ثم أعد تشغيل التطبيق.
تأكد من نجاح التثبيت:
sahmk-mcp --helpالربط مع Claude Desktop
أضف هذا الإعداد إلى ملف Claude Desktop.
على macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
على Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key_here"
}
}
}
}أعد تشغيل Claude Desktop. ستظهر أدوات سهمك في قائمة الأدوات.
الربط مع Cursor
أضف هذا الإعداد إلى ملف مشروعك .cursor/mcp.json:
{
"mcpServers": {
"sahmk": {
"command": "sahmk-mcp",
"env": {
"SAHMK_API_KEY": "your_api_key_here"
}
}
}
}أعد تشغيل Cursor. ستصبح أدوات سهمك متاحة لمساعد المحرّر.
5. جرّبه بنفسك
بعد إتمام الربط في ChatGPT أو Claude أو Cursor، اسأل بالعربية أو الإنجليزية. الأدوات والحدود واحدة لأن كل الحالات تستخدم اشتراك سهمك نفسه.
أدوات الأسعار تقبل الرمز، أو اسم الشركة بالعربية أو الإنجليزية، أو الاسم البديل. وإذا طابق الاسم أكثر من شركة، اطلب إعادة المحاولة بالرمز الدقيق.
للبحث عن الشركة أولاً استخدم companies_list (وتدعم search, market, limit، وoffset).
مثال على السؤال
ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟
يسأل عن سعر أرامكو وحجم التداول وأفضل سعري طلب وعرض.
مثال على السؤال
كيف حال السوق السعودي اليوم؟يستدعي get_market_summary.
مثال على السؤال
اعرض أعلى الرابحين في تاسييستدعي get_market_movers.
مثال على السؤال
اعرض أداء القطاعات في تاسييستدعي get_sectors.
مثال على السؤال
اعرض القوائم المالية لأرامكويستدعي get_financials.
مثال على السؤال
اعرض توزيعات أرامكويستدعي get_dividends.
مثال على السؤال
قارن أرامكو ومصرف الراجحييستدعي get_quotes.
مثال على السؤال
اعرض تاريخ سعر أرامكو لآخر ثلاثة أشهريستدعي get_historical.
قد تتطلب أداتا get_financials وget_dividends باقة Starter أو أعلى.
6. الباقات المتاحة
هذه الحدود تنطبق على أدوات MCP في ChatGPT وعلى التثبيت المحلي معاً.
| الباقة | السعر | الطلبات/اليوم |
|---|---|---|
| مجاني | 0 SAR | 100 |
| Starter | 149 SAR/mo | 5,000 |
| Pro | 499 SAR/mo | 50,000 |
| Business | 1,499 SAR/mo | 150,000 |
| Enterprise | تواصل معنا | مخصص حسب الاتفاق |
الباقة المجانية تمنحك 100 طلب يومياً، وهذا يكفي للتجربة والبدء.
7. الخطوات التالية
- →تصفح الشيفرة المصدرية لسهمك MCP على GitHub
- →ابدأ بـدليل Python SDK لبناء تطبيقاتك
- →راجع مرجع API لكل الواجهات المتاحة
اجعل مساعدك يصل إلى بيانات تداول
أضف سهمك من دليل إضافات ChatGPT أو دليل Claude، أو ثبّت الخادم على جهازك لـClaude Desktop وCursor. 100 طلب مجاني يومياً، ومن دون بطاقة ائتمان.