تكامل خادم Neo4j MCP

ماذا يفعل خادم “Neo4j” MCP؟

خادم Neo4j MCP (بروتوكول سياق النموذج) هو أداة متخصصة تربط بين المساعدين الذكاء الاصطناعي وقاعدة بيانات الرسوم البيانية Neo4j. يتيح تفاعلات سلسة بين نماذج اللغة الكبيرة (LLMs) وNeo4j، مما يسمح للمطورين والمستخدمين بأداء عمليات على قاعدة بيانات الرسوم البيانية عبر تعليمات باللغة الطبيعية. من خلال عمله كوسيط، يمكّن خادم Neo4j MCP تدفقات العمل المعتمدة على الذكاء الاصطناعي من تنفيذ استعلامات Cypher، وإدارة العقد والعلاقات، واسترجاع النتائج المنظمة من قاعدة البيانات. يعزز هذا التكامل الإنتاجية بجعل العمليات المعقدة على قاعدة البيانات سهلة الوصول، وقابلة للأتمتة، وآمنة ضمن بيئات تطوير تعتمد على الذكاء الاصطناعي.

قائمة الموجهات

لا توجد قوالب موجهات صريحة مذكورة في توثيق المستودع المتاح.

قائمة المصادر

لا توجد مصادر موثقة صراحة في المستودع.

قائمة الأدوات

• execute_query: ينفذ استعلامات Cypher على قاعدة بيانات Neo4j. يدعم جميع عمليات Cypher (قراءة، إنشاء، تحديث، حذف)، ويسمح بتمرير المعاملات لمنع الحقن، ويعيد نتائج منظمة.
• create_node: ينشئ عقدة جديدة في قاعدة بيانات الرسوم البيانية. يمكن للمستخدمين تحديد تسميات العقد وخصائصها، مع دعم جميع أنواع بيانات Neo4j. يعيد العقدة التي تم إنشاؤها ومعرفها الداخلي.
• create_relationship: ينشئ علاقة بين عقدتين موجودتين. يمكن للمستخدمين تحديد نوع العلاقة واتجاهها، وإضافة الخصائص، ويجب تقديم معرفات العقدة المصدر والهدف.

حالات استخدام هذا الخادم MCP

• استعلام قاعدة بيانات الرسوم البيانية: يتيح للمستخدمين تشغيل استعلامات Cypher معقدة على Neo4j باستخدام اللغة الطبيعية، مما يسهل استرجاع البيانات وتحليلها وإعداد التقارير.
• إنشاء وإدارة بيانات الرسوم البيانية: يسمح للمطورين بإنشاء العقد والعلاقات برمجياً، ويدعم مهام نمذجة البيانات والهجرة والإثراء.
• استكشاف البيانات بمساعدة الذكاء الاصطناعي: يمكّن المساعدين الذكاء الاصطناعي من مساعدة المستخدمين في استكشاف وفهم هياكل الرسوم البيانية، واكتشاف الرؤى دون الحاجة لكتابة الاستعلامات يدوياً.
• أتمتة عمليات البيانات: يمكن دمجه مع سير العمل البرمجي لأتمتة العمليات المتكررة على قاعدة البيانات، مما يحسن الاتساق ويوفر الوقت.
• إجراءات مؤمنة بمعاملات: يوفر واجهة آمنة لإدارة البيانات، مع دعم للاستعلامات المُعلمة لمنع هجمات الحقن وضمان معالجة بيانات آمنة.

كيفية الإعداد

Windsurf

1. تأكد من وجود Node.js مثبت على جهازك.
2. افتح ملف إعدادات Windsurf.
3. أضف إدخال خادم Neo4j MCP في كائن mcpServers الخاص بك:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server@latest"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

4. احفظ الإعدادات وأعد تشغيل Windsurf.
5. تأكد من أن الخادم يعمل ويمكن الوصول إليه في عميل MCP الخاص بك.

Claude

1. قم بتثبيت Node.js إذا لم يكن موجوداً بالفعل.
2. افتح ملف إعدادات Claude Desktop.
3. أدخل إعدادات خادم Neo4j MCP كما يلي:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server@latest"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

4. احفظ وأعد تشغيل Claude Desktop.
5. تحقق من نجاح الاتصال بقاعدة بيانات Neo4j الخاصة بك.

Cursor

1. تأكد من تثبيت Node.js.
2. افتح ملف إعدادات Cursor.
3. أضف إعدادات خادم MCP التالية:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server@latest"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

4. احفظ التغييرات وأعد تشغيل Cursor.
5. اختبر الاتصال للتأكد من عمله.

Cline

1. تأكد من توفر Node.js على جهازك.
2. حدد موقع وافتح ملف إعدادات Cline.
3. أضف إعدادات خادم Neo4j MCP:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server@latest"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

4. احفظ وأعد تشغيل Cline.
5. تحقق من تكامل MCP للتأكد من عمله.

تأمين مفاتيح الـ API:
احرص دائماً على تخزين بيانات الاعتماد الحساسة (مثل NEO4J_PASSWORD) باستخدام متغيرات البيئة، وليس القيم المكتوبة بشكل صريح. على سبيل المثال:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server@latest"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "${NEO4J_PASSWORD}"
      }
    }
  }
}

كيفية استخدام هذا الخادم MCP ضمن التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام لـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق لـ JSON:

{
  "neo4j": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، يصبح وكيل الذكاء الاصطناعي قادراً على استخدام هذا MCP كأداة والوصول إلى جميع وظائفه وإمكانياته. تذكر تغيير “neo4j” إلى الاسم الفعلي لخادم MCP الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

دعم الجذور: ⛔ (غير موثق)

بين التوثيق والميزات المتاحة، هذا الخادم MCP متخصص وفعّال جداً لعمليات Neo4j، لكنه يفتقر إلى توثيق للموجهات والمصادر والجذور والعينات. لمهام قواعد البيانات، يحصل على تقييم جيد من حيث الفائدة والوضوح، لكن أقل من ناحية قابلية التوسعة أو ميزات MCP الأوسع.

تقييم MCP