خادم MSSQL MCP

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

خادم MSSQL MCP هو أداة مصممة لربط المساعدين الذكيين مع قواعد بيانات Microsoft SQL Server، مما يمكّن من التفاعل المتقدم مع قواعد البيانات وتحليل الأعمال مباشرة من تدفقات الذكاء الاصطناعي. من خلال بروتوكول سياق النماذج (MCP)، يسهل تنفيذ استعلامات SQL بسلاسة، وتحليل بيانات الأعمال، وتوليد مذكرات رؤى الأعمال. يمنح هذا الخادم وكلاء الذكاء الاصطناعي والمطورين القدرة على تنفيذ مهام مثل قراءة وكتابة سجلات قاعدة البيانات، إدارة مخططات القاعدة، واستخلاص رؤى قابلة للتنفيذ، مما يبسط عمليات قواعد البيانات ويؤتمت مهام تحليل الأعمال. من خلال ربط المصادر الخارجية للبيانات مع المساعدين الذكيين، يعزز خادم MSSQL MCP سير عمل التطوير بشكل كبير ويوفر أتمتة ذكية وواعية بالسياق في بيئات المؤسسات.

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

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

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

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

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

• read_query
  تنفيذ استعلامات SELECT لقراءة البيانات من قاعدة بيانات SQL Server.
• write_query
  تنفيذ استعلامات INSERT أو UPDATE أو DELETE لتعديل سجلات قاعدة البيانات.
• create_table
  إنشاء جداول جديدة ضمن قاعدة بيانات SQL Server.
• list_tables
  استرجاع قائمة بكل الجداول الموجودة في القاعدة.
• describe-table
  عرض معلومات المخطط لجدول محدد.
• append_insight
  إضافة رؤى أعمال جديدة إلى مورد المذكرة.

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

• إدارة قواعد البيانات
  تمكين وكلاء الذكاء الاصطناعي من قراءة وكتابة وإدارة قواعد بيانات SQL Server، مما يسهل عمليات CRUD (إنشاء، قراءة، تحديث، حذف) برمجياً لتبسيط التعامل مع البيانات.
• تحليل بيانات الأعمال
  يسمح بتنفيذ استعلامات تحليلية لاستخلاص وتجميع وتحليل بيانات الأعمال، مما يساعد في توليد رؤى قابلة للتنفيذ.
• استكشاف المخطط
  يوفر أدوات لعرض الجداول ووصف مخططات الجداول، مما يمكّن من استكشاف وتوثيق بنية القاعدة بشكل شامل.
• التوليد المؤتمت لرؤى الأعمال
  يمكن استخدام أداة append_insight لتوليد وتسجيل مذكرات رؤى الأعمال تلقائياً بناءً على البيانات المحللة، مما يدعم اتخاذ القرار.
• التكامل مع أدوات تطوير الذكاء الاصطناعي
  يمكن دمجه في بيئات مثل Claude وWindsurf وCursor وCline لتعزيز أتمتة سير العمل وتسهيل اختبار ونشر تطبيقات قواعد بيانات مدعومة بالذكاء الاصطناعي.

كيفية إعداده

Windsurf

1. المتطلبات الأساسية: تأكد من تثبيت Python 3.x مع الحزم المطلوبة (pyodbc، pydantic، mcp). ثبتها بـ pip install -r requirements.txt.

2. تهيئة القاعدة: أنشئ ملف config.json في نفس مجلد server.py وضع فيه تفاصيل الاتصال بـ SQL Server (انظر مثال الإعداد أدناه).

3. تعديل الإعدادات: أضف المدخل التالي إلى ملف إعداد Windsurf (أو Claude Desktop):

   {
     "mcpServers": {
       "mssql": {
         "command": "python",
         "args": [
           "~/server.py"
         ]
       }
     }
   }
   

4. احفظ وأعد التشغيل: احفظ ملف الإعدادات وأعد تشغيل Windsurf.

5. تحقق من الإعداد: تأكد من أن خادم MCP يعمل وقابل للوصول من Windsurf.

Claude

1. تثبيت المتطلبات: تأكد من تثبيت المتطلبات حسب requirements.txt.

2. تهيئة القاعدة: أنشئ واملأ config.json كما هو موضح أدناه.

3. إضافة خادم MCP: في claude_desktop_config.json، أضف:

   {
     "mcpServers": {
       "mssql": {
         "command": "python",
         "args": [
           "~/server.py"
         ]
       }
     }
   }
   

4. أعد تشغيل Claude Desktop: أعد التشغيل لتحميل الإعداد الجديد.

5. اختبر الاتصال: تأكد من الاتصال بخادم MSSQL MCP.

Cursor

1. تثبيت المتطلبات: استخدم pip install -r requirements.txt.

2. تهيئة القاعدة: أنشئ config.json بمحددات SQL Server الخاصة بك.

3. إضافة خادم MCP في Cursor: في لوحة إعداد MCP، أضف:

   {
     "mcpServers": {
       "mssql": {
         "command": "python",
         "args": [
           "~/server.py"
         ]
       }
     }
   }
   

4. احفظ/أعد التشغيل: احفظ التغييرات وأعد تشغيل Cursor.

5. تحقق: تأكد من أن Cursor تعرف على خادم MCP.

Cline

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

مثال config.json لاتصال القاعدة

{
  "database": {
    "driver": "ODBC Driver 17 for SQL Server",
    "server": "server ip",
    "database": "db name",
    "username": "username",
    "password": "password",
    "trusted_connection": false
  },
  "server": {
    "name": "mssql-manager",
    "version": "0.1.0"
  }
}

تأمين مفاتيح API باستخدام متغيرات البيئة

لا يوجد ذكر صريح لطريقة التعامل مع مفاتيح API أو متغيرات البيئة في وثائق المستودع. تأكد من وضع الاعتمادات الحساسة (مثل اسم المستخدم وكلمة السر) عبر متغيرات البيئة إذا كان ذلك مدعوماً في بيئة تشغيلك. مثال:

{
  "database": {
    "username": "${MSSQL_USER}",
    "password": "${MSSQL_PASS}"
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

رأينا

يقدم خادم MSSQL MCP مجموعة قوية من أدوات قواعد البيانات وأمثلة إعداد للمنصات الكبرى، لكنه يفتقر لتعريفات صريحة لقوالب أو موارد MCP ولإرشادات الأمان/متغيرات البيئة. هو مفيد جداً لأتمتة SQL Server، لكن سيستفيد من توثيق أغنى وأفضل ممارسات أمان.

التقييم: 6/10 — أداء جوهري جيد ومفتوح المصدر، لكن ينقصه بعض ميزات MCP المتقدمة وعمق التوثيق.

تقييم MCP