خادم الذاكرة MCP
يعمل على جهازك.
telys mcp هو خادم ذاكرة MCP محلي عبر stdio لـ Claude Code وClaude Desktop وCursor وCodex. يُشغّله عميلك كعملية فرعية — لا منفذ، لا خدمة خلفية، لا اعتماد على السحابة. ما يخزّنه المساعد يبقى عبر الجلسات، في مخزن محكوم على قرصك.
ثلاثة أوامر. كل عميل.
الحزمة مرخصة بـ Apache-2.0. يسجّل telys login دخولك مرة واحدة، ثم يوفّر وقت التشغيل الموقّع المرخّص للجهاز ويتحقق منه — بعد ذلك يعمل الخادم دون اتصال كامل. يكتب telys mcp install مدخل الخادم في إعدادات كل عميل: يكتشف العملاء المثبّتين تلقائياً، ويدمج بشكل متكرر آمن، ويحتفظ بنسخة احتياطية من كل ملف يلمسه.
pipx install telys # Apache-2.0 SDK
telys login # one sign-in → signed device license
telys mcp install # register the server in your clients
# defaults: auto-detect installed clients, user scopetelys mcp install --client claude|cursor|codex|claude-desktop|all --scope user|project # defaults: auto-detect installed clients, user scope
نسخة تجريبية عامة — `pipx install telys` من PyPI، ثم `telys login` (مجاناً لمطوّر واحد) يوفّر وقت التشغيل الموقَّع على الجهاز.
بيئة صفرية. وقت تشغيل يحدد موقعه بنفسه.
يحصل كل عميل على المدخل القياسي ذاته: تشغيل telys بالوسيطة الوحيدة mcp. لا PYTHONPATH، لا مسارات نواة، لا مفاتيح في الإعداد — يحدد وقت التشغيل موقعه بنفسه من تثبيت telys login الموثّق.
النقل هو MCP stdio: JSON-RPC 2.0 محدود بسطر جديد عبر stdin/stdout، مع امتلاك العميل لدورة حياة العملية. حيث تمتلك واجهة سطر أوامر العميل ملف إعداده، يُفوّض المثبّت إليها — claude mcp add لـ Claude Code، وcodex mcp add لـ Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}ذاكرة دائمة، على الجهاز، محكومة.
الذاكرة تتجاوز الجلسة
الملاحظات والقرارات والسياق المخزّن عبر telys_add لا تزال موجودة في الجلسة التالية، الأسبوع التالي، أو من عميل مختلف. المخزن حالة مشتركة، لا حالة محادثة.
مجلد على قرصك
تعيش الذكريات في ~/.telys/memory، أو أينما يشير $TELYS_MEMORY_PATH. تُنفَّذ عمليتا الإضافة والبحث داخل العملية مقابل المحرك المحلي — دون اتصال بعد telys login، لا شيء يغادر الجهاز وقت الاستعلام.
استدعاء مقسّم وقابل للتصفية
تُقسَّم المجموعات بمفتاح نطاق. يجمع البحث المطابقة الدلالية والمعجمية ويقبل فلتر مساواة — المحرك ذاته الذي يُعيد خطة explain في كل استعلام SDK.
| الأداة | ما تفعله |
|---|---|
| telys_search | بحث دلالي ومعجمي في مجموعة ذاكرة. top_k اختياري وفلتر مساواة بمفتاح واحد. |
| telys_add | إضافة مستندات نصية إلى مجموعة، تُنشأ إن لم تكن موجودة. معرّفات وبيانات وصفية لكل مستند اختيارية. |
| telys_create_collection | إنشاء مجموعة؛ مفتاح التقسيم الافتراضي هو scope. |
| telys_list_collections | سرد المجموعات في المخزن. |
| telys_stats | إحصاءات المخزن لمجموعة محددة. |
افحصه. أزله.
يُبلّغ `telys mcp status` عن مواضع تسجيل الخادم عبر إعدادات العملاء. يلغي `telys mcp uninstall` تسجيله، ويقبل خياري `--client` و`--scope` ذاتهما المستخدمَين في التثبيت، مع نسخ احتياطي لكل ملف إعداد قبل الكتابة. تتوفر أدوات الذاكرة ذاتها أيضاً من الطرفية عبر `telys mem`.
telys mcp # run the stdio server (what your client launches) telys mcp status # where is the server registered? telys mcp uninstall # deregister (--client / --scope, as at install) telys mcp --path <dir> # point the server at a specific memory root
claude mcp add، أو .mcp.json
نطاق المستخدم يُسجَّل عبر الأمر الرسمي `claude mcp add`. نطاق المشروع يكتب ملف `.mcp.json` نظيفاً مخصصاً لـ MCP في جذر المستودع — آمن للإيداع.
claude_desktop_config.json
يدمج الإدخال في ملف إعداد التطبيق ضمن مجلد الإعداد الخاص بالمنصة. أعد تشغيل Claude Desktop لتحميل الخادم.
~/.cursor/mcp.json
يكتب ملف `mcp.json` على مستوى المستخدم، أو `.cursor/mcp.json` داخل المشروع عند استخدام `--scope project`.
codex mcp add، أو config.toml
يُسجَّل عبر `codex mcp add` حين تتوفر واجهة سطر الأوامر؛ وإلا يُلحق كتلة `[mcp_servers.telys]` بملف `config.toml`.
أضف Telys إلى عميل MCP لديك.
Telys في نسخة تجريبية عامة (0.1.0b4). الـ SDK مرخَّص بـ Apache-2.0 على PyPI — pipx install telys، ثم telys login يوفّر وقت التشغيل الموقَّع على الجهاز، مجاناً لمطوّر واحد.