خادم MCP لبيئات التطوير (IDE)

خادم MCP لبيئات التطوير (MCP IDE Server)

توفر كاظمة خادمًا مدمجًا لبروتوكول سياق النماذج (MCP IDE Server) يعمل عبر معيار stdio JSON-RPC 2.0 (kazma_gateway/mcp_server.py). يتيح هذا الخادم لبيئات التطوير مثل VS Code وCursor وClaude Desktop الاستفادة من محرك كاظمة للبحث في الشيفرة وقراءة الملفات وتشغيل الاختبارات البرمجية مباشرة.

---

الأدوات المتاحة

اسم الأداة	مستوى الأمان	الوصف
search_code	قراءة فقط	بحث سريع باستخدام التعابير النمطية (Regex) مع تصفية الملفات.
read_file	قراءة فقط	قراءة محتويات الملفات مع ترقيم الأسطر وحد أقصى 1 ميغابايت.
write_file	أداة حساسة	كتابة وتعديل الملفات بأمان مع الحماية من تجاوز المسار (Path Traversal).
run_tests	أداة حساسة	تشغيل اختبارات pytest مع مهلة زمنية وفلاتر للكلمات المفتاحية.

---

التهيئة والربط

الإعداد في claude_desktop_config.json أو Cursor

{
  "mcpServers": {
    "kazma-ide": {
      "command": "python",
      "args": ["-m", "kazma_gateway.mcp_server"],
      "env": {
        "KAZMA_SECRET": "your-secure-shared-secret",
        "KAZMA_MCP_IDE_ENABLED": "true"
      }
    }
  }
}

---

معايير الأمان وضوابط الحماية

1. التحقق من المفتاح السري: الأدوات الحساسة (write_file و run_tests) تتطلب مطابقة KAZMA_SECRET لمنع أي تنفيذ غير مصرح به.
2. عزل المسار: التحقق من بقاء كافة مسارات الملفات ضمن المجلد الجذري للمشروع لمنع الوصول إلى ملفات النظام الحساسة.