خادم MariaDB MCP

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

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

قائمة التعليمات

لا توجد قوالب تعليمات مذكورة في الوثائق المتوفرة.

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

• كشف قائمة المخططات
  يقوم الخادم بكشف قائمة المخططات في قاعدة بيانات MariaDB المتصلة، مما يسمح للعملاء بمشاهدة هياكل البيانات المتاحة.
  (لم تذكر أي موارد أخرى صراحة.)

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

• query_database
  تتيح تنفيذ عمليات للقراءة فقط على مثيل MariaDB. تمكن هذه الأداة المستخدمين من إجراء استعلامات SELECT وجلب البيانات للتحليل أو إدماجها في تدفقات العمل.

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

• استكشاف قواعد البيانات
  يمكن للمطورين وعلماء البيانات جلب معلومات المخطط وتنفيذ استعلامات للقراءة فقط لفهم بنية قواعد بيانات MariaDB دون خطر التعديل العرضي.

• ذكاء الأعمال
  يمكّن مساعدي الذكاء الاصطناعي من تزويد لوحات القيادة أو إنشاء تقارير عبر استعلام بيانات حية من قواعد MariaDB بشكل آمن للقراءة فقط.

• تصحيح التطبيقات
  يمكن للمطورين استخدام الخادم لمعاينة البيانات والتحقق منها بأمان داخل قواعد البيانات الإنتاجية، مما يدعم مهام الاستكشاف والتحقق.

• تحليل البيانات الآلي
  يمكن لأدوات الذكاء الاصطناعي جلب ومعالجة سجلات قاعدة البيانات للتحليل الإحصائي، وتحديد الاتجاهات، أو تدريب نماذج التعلم الآلي.

كيفية إعداده

Windsurf

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

Claude

1. تحديد ملف الإعدادات:
   • ماك: ~/Library/Application Support/Claude/claude_desktop_config.json
   • ويندوز: %APPDATA%\Claude\claude_desktop_config.json
2. إضافة إعدادات خادم MCP:
   أدخل مقطع JSON التالي، مع استبدال القيم النائبة بالقيم الفعلية:

   {
       "mcpServers": {
           "mcp_server_mariadb": {
               "command": "/PATH/TO/uvx",
               "args": [
                   "mcp-server-mariadb",
                   "--host",
                   "${DB_HOST}",
                   "--port",
                   "${DB_PORT}",
                   "--user",
                   "${DB_USER}",
                   "--password",
                   "${DB_PASSWORD}",
                   "--database",
                   "${DB_NAME}"
               ]
           }
       }
   }
   

3. استبدال القيم النائبة:
   • قم بتحديث /PATH/TO/uvx إلى المسار الكامل لملف تنفيذ uvx الخاص بك.
4. الحفظ وإعادة التشغيل:
   • احفظ التعديلات وأعد تشغيل Claude Desktop لتفعيل الخادم.
5. التحقق من الاتصال:
   • تأكد من أن الخادم يعمل ويتصل بنجاح بمثيل MariaDB.

مثال لخادم غير منشور/تطوير:

{
    "mcpServers": {
        "mcp_server_mariadb": {
            "command": "/PATH/TO/uv",
            "args": [
                "--directory",
                "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
                "run",
                "server.py"
            ],
            "env": {
                "MARIADB_HOST": "127.0.0.1",
                "MARIADB_USER": "USER",
                "MARIADB_PASSWORD": "PASSWORD",
                "MARIADB_DATABASE": "DATABASE",
                "MARIADB_PORT": "3306"
            }
        }
    }
}

تذكر استبدال جميع المسارات وبيانات الاعتماد النائبة حسب الحاجة.

Cursor

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

Cline

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

تأمين مفاتيح API

عند إعداد بيئتك، استخدم متغيرات البيئة للبيانات الحساسة. مثال:

"env": {
    "MARIADB_HOST": "127.0.0.1",
    "MARIADB_USER": "USER",
    "MARIADB_PASSWORD": "PASSWORD",
    "MARIADB_DATABASE": "DATABASE",
    "MARIADB_PORT": "3306"
}

قم بتخزين القيم بشكل آمن ولا تكتب الأسرار مباشرة في ملفات الإعدادات.

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

استخدام MCP في FlowHunt

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

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

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

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع الوصول إلى كافة وظائفه وإمكاناته. تذكر تغيير "mcp_server_mariadb" إلى الاسم الفعلي لخادم MCP الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

استنادًا إلى الجداول أعلاه، فإن خادم MariaDB MCP بسيط ومركّز، ويقدم الوظائف الأساسية للوصول إلى قاعدة بيانات MariaDB. يفتقر إلى ميزات MCP المتقدمة مثل قوالب التعليمات أو دعم العينات، لكنه متفوق في الجوانب الأساسية كالأدوات، الموارد، والإعداد الآمن. بالنسبة لخادم قاعدة بيانات للقراءة فقط، فهو قوي ولكنه أساسي.

تقييم MCP