إعداد عن بُعد

يعمل lean-ctx كـ خادم MCP عبر stdio - يقوم عميل الذكاء الاصطناعي بتشغيله كعملية فرعية محلية. للخوادم البعيدة أو الحاويات أو البيئات headless يمكنك تمرير الاتصال عبر SSH. لا حاجة لأي مكوّن خادم إضافي.

نفق SSH (موصى به)

أبسط نهج: اضبط عميل الذكاء الاصطناعي لتشغيل lean-ctx عبر SSH. يتدفق بروتوكول MCP عبر stdin/stdout الخاص بـ SSH - بدون فتح منافذ، بدون HTTP، وبدون إدارة مصادقة إضافية. يتولى SSH التشفير والمصادقة بشكل أصيل.

1. ثبّت lean-ctx على الخادم البعيد

اتصل بالخادم عبر SSH وثبّت lean-ctx:

ssh user@server
cargo install lean-ctx
# or download pre-built binary:
curl -fsSL https://leanctx.com/install.sh | sh

2. اختبر الاتصال

تحقق أن lean-ctx يعمل عبر SSH. يمكنك تشغيل خادم MCP مباشرة أو تمرير لوحة التحكم عبر نفق:

# Terminal 1: SSH tunnel (keeps running)
ssh -L 3333:localhost:3333 user@server "lean-ctx dashboard --port 3333"

# Or just forward the MCP stdio over SSH:
ssh user@server "lean-ctx"

3. اضبط عميل الذكاء الاصطناعي

اجعل إعداد MCP لعميلك يشغل lean-ctx عبر SSH. يعمل ذلك مع Cursor وClaude Code وWindsurf وأي عميل يدعم MCP:

// ~/.cursor/mcp.json or ~/.claude.json
{
  "mcpServers": {
    "lean-ctx": {
      "command": "ssh",
      "args": ["user@server", "lean-ctx"]
    }
  }
}

هذا يوجّه العميل لتشغيل ssh user@server "lean-ctx" بدلًا من lean-ctx محلي. يتدفق بروتوكول MCP بشفافية عبر اتصال SSH - ويتم تمرير stdin/stdout تلقائيًا.

إعادة توجيه المنافذ (لوحة التحكم)

إذا أردت الوصول إلى لوحة تحكم lean-ctx (Observatory) من متصفحك المحلي بينما يعمل lean-ctx على خادم بعيد، استخدم إعادة توجيه المنافذ عبر SSH:

إعداد SSH دائم

# ~/.ssh/config
Host dev-server
  HostName 192.168.1.100
  User developer
  LocalForward 3333 localhost:3333
  ServerAliveInterval 60
  ServerAliveCountMax 3

ثم اتصل وابدأ لوحة التحكم:

ssh dev-server "lean-ctx dashboard --port 3333"
# Dashboard now available at http://localhost:3333

VS Code Remote SSH

إذا كنت تستخدم VS Code مع إضافة Remote - SSH فسيعمل lean-ctx تلقائيًا - يعمل خادم MCP على الجهاز البعيد مثل أي أمر في الطرفية. ثبّت lean-ctx على الجهاز البعيد وشغّل lean-ctx setup وسيقوم بتهيئة نفسه للبيئة البعيدة.

Docker / حاويات

للتطوير داخل الحاويات، قم بتركيب ملف lean-ctx التنفيذي ودليل بياناته داخل الحاوية:

# Mount lean-ctx binary into your dev container
docker run -it \
  -v $(which lean-ctx):/usr/local/bin/lean-ctx:ro \
  -v ~/.lean-ctx:/root/.lean-ctx \
  your-dev-image bash

في Docker Compose أضف الـ volumes إلى خدمتك:

# docker-compose.yml
services:
  dev:
    image: your-dev-image
    volumes:
      - ./:/workspace
      - lean-ctx-bin:/usr/local/bin/lean-ctx:ro
      - ~/.lean-ctx:/root/.lean-ctx

استكشاف الأخطاء وإصلاحها

انقطاع الاتصال بعد فترة خمول

قد تنتهي مهلة اتصالات SSH خلال فترات خمول طويلة. أضف إعدادات keepalive:

ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=3 user@server "lean-ctx"

Permission denied على الخادم البعيد

تأكد أن lean-ctx موجود في PATH لمستخدم الخادم البعيد. إذا ثُبّت عبر cargo install فمكانه ~/.cargo/bin/lean-ctx. أضف export PATH=\"$HOME/.cargo/bin:$PATH\" إلى ~/.bashrc أو ~/.zshrc على الخادم البعيد.

اختلاف الإصدار بين المحلي والبعيد

يجب أن يعمل عميل الذكاء الاصطناعي المحلي وlean-ctx البعيد على نفس الإصدار لتجنب مشاكل البروتوكول. حدّثهما معًا:

# Check versions on both machines
lean-ctx --version              # local
ssh user@server "lean-ctx --version"  # remote

تشغيل التشخيص على الخادم البعيد

استخدم lean-ctx doctor على الخادم البعيد للتحقق من التثبيت وhooks الخاصة بالـ shell وإعداد MCP:

ssh user@server "lean-ctx doctor"