ما هو MCP؟
Model Context Protocol يتيح لـ LLMs استدعاء أدوات خارجية. يعرض Synapse 79 أداة عبر خادم MCP رسمي.
ما هو MCP؟
Model Context Protocol (MCP) معيار مفتوح من Anthropic (2024) يتيح لـ LLMs استدعاء أدوات خارجية بطريقة منظمة. بدلًا من لصق وثائق API في الـ prompt، تسجّل الأدوات مع خادم MCP، ويستدعيها الـ LLM عند الحاجة — مثل استدعاء الدوال، لكن موحّد ومستقل عن العميل.
خادم Synapse MCP
يأتي Synapse بخادم MCP رسمي (synapse-mcp-api على npm) يعرض
79 أداة تغطي جميع ميزات Synapse:
| الفئة | الأدوات | العدد |
|---|---|---|
| الذاكرة | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |
| الدردشة | poll, reply, status, history, unread, send, upload | 7 |
| المجدول | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| المهام | task_list, task_get, task_create, task_update | 4 |
| السكربتات | script_list, script_get, script_info, script_store, script_delete | 5 |
| الأجهزة | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| الإشعارات | vapid_public_key, subscribe, unsubscribe, test | 4 |
| المستخدم/العقل | register, login, minds_list, mind_create, mind_delete | 5 |
| الأدوات | time, calc, random | 3 |
| التصور | graph, tags, compact | 3 |
| المشاركة | share, list, revoke | 3 |
| الـ Webhooks | register, list, get, update, delete | 5 |
| المتصفح | new, navigate, click, type, screenshot, close | 6 |
| الإجمالي | 79+ |
كيف يعمل
┌──────────────────┐ MCP protocol ┌──────────────────┐ HTTP ┌──────────┐
│ LLM Client │ ◀─────────────────▶│ Synapse MCP │ ─────────▶ │ Synapse │
│ (Claude/Cursor) │ (stdio/SSE/WS) │ Server │ │ API │
└──────────────────┘ └──────────────────┘ └──────────┘- تُعدّ عميل LLM (Claude Desktop، Cursor، إلخ) لاستخدام خادم Synapse MCP
- يبدأ العميل خادم MCP (عبر
npx -y synapse-mcp-api@latest) - يتصل خادم MCP بـ Synapse API باستخدام Mind Key الخاص بك
- يرى الـ LLM جميع الأدوات الـ 79 كدوال أصلية يستطيع استدعاءها
- عندما يحتاج الـ LLM لتذكر شيء، يستدعي
memory_store— يترجم خادم MCP هذا إلىPOST /memoryعلى Synapse
وسائل النقل
يدعم خادم Synapse MCP ثلاث وسائل نقل:
stdio (محلي، موصى به لسطح المكتب)
{
"mcpServers": {
"synapse": {
"command": "npx",
"args": ["-y", "synapse-mcp-api@latest"],
"env": {
"SYNAPSE_MIND_KEY": "mk_...",
"SYNAPSE_URL": "https://synapse.schaefer.zone"
}
}
}
}HTTP/SSE (بعيد، متعدد المستأجرين)
اربط عميل MCP الخاص بك بـ:
URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEYWebSocket (موبايل، حجم عالي)
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEYملفات الأدوات (v1.4.0)
لتقليل عبء الرموز لـ LLMs أصغر، خادم MCP يدعم ثلاثة ملفات أدوات:
| الملف | الأدوات | الرموز | الأفضل لـ |
|---|---|---|---|
minimal |
8 (إرسال مركب) | ~500 | LLMs مستضافة ذاتيًا بسياق ≤8k |
standard |
25 (مُسمّاة) | ~2,500 | LLMs متوسطة (Claude Haiku، GPT-3.5) |
full |
119 (الكل) | ~8,250 | LLMs كبيرة (Claude Sonnet/Opus، GPT-4) — افتراضي |
التحكم عبر:
- متغير البيئة:
MCP_PROFILE=minimal|standard|full - الترويسة:
Mcp-Tool-Profile: minimal|standard|full
العملاء المدعومون
- Claude Desktop — تطبيق سطح المكتب من Anthropic
- Claude Code — وكيل برمجة طرفي
- Cursor — IDE ذكي مدعوم بـ AI
- Continue.dev — مساعد برمجة ذكي مفتوح المصدر
- Cline — امتداد VS Code
- أي عميل متوافق مع MCP
لماذا تستخدم MCP بدلًا من API مباشر؟
| النهج | المزايا | العيوب |
|---|---|---|
| API مباشر | بسيط، بلا طبقة إضافية | يحتاج LLM معرفة عناوين URL، الترويسات، المصادقة |
| MCP | يرى الـ LLM أدوات أصلية، بلا حفظ URL | عملية خادم MCP إضافية |
لمعظم حالات استخدام وكلاء LLM، MCP الخيار الأفضل — الـ LLM لا يحتاج لتذكر مسارات API أو أنماط المصادقة.
الخطوات التالية
- إعداد Claude Desktop — إعداد بدقيقتين
- إعداد Claude Code — تكامل الـ terminal
- عميل MCP مخصص — ابنِ خاصتك