خادم BigQuery MCP

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

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

قائمة المحفزات

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

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

لم يتم توثيق موارد MCP محددة في المستودع أو ملف README.

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

لا توجد قائمة أدوات صريحة أو ملف server.py في التوثيق أو بنية الكود المتوفرة.

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

• استكشاف البيانات باللغة الطبيعية
  يمكن للمستخدمين طرح الأسئلة بالإنجليزية البسيطة (مثال: “من هم أفضل 10 عملاء لدينا الشهر الماضي؟”) والحصول على الإجابات مباشرة من BigQuery، مما يقلل الحاجة لكتابة استعلامات SQL يدوياً.

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

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

• تحليل البيانات ضمن حدود آمنة
  يفرض حدوداً للاستعلامات (مثلاً، 1GB افتراضياً)، لضمان التحكم في استخدام الموارد ومنع الاستعلامات المكلفة عن طريق الخطأ.

كيفية إعداده

Windsurf

لا توجد تعليمات إعداد لـ Windsurf في المستودع.

Claude

1. المتطلبات المسبقة:

   • تثبيت Node.js 14 أو أحدث.
   • تفعيل BigQuery في مشروع Google Cloud الخاص بك.
   • تثبيت Google Cloud CLI أو الحصول على ملف مفتاح حساب خدمة.
   • تثبيت Claude Desktop.

2. المصادقة مع Google Cloud:

   • للتطوير:

     gcloud auth application-default login
     

   • للإنتاج (حساب خدمة):
     • احفظ ملف مفتاح حساب الخدمة الخاص بك.
     • استخدم معلمة --key-file عند تشغيل الخادم.

3. الإضافة إلى إعدادات Claude Desktop:
   عدل ملف claude_desktop_config.json لديك:

   {
     "mcpServers": {
       "bigquery": {
         "command": "npx",
         "args": [
           "-y",
           "@ergut/mcp-bigquery-server",
           "--project-id",
           "your-project-id",
           "--location",
           "us-central1"
         ]
       }
     }
   }
   

4. احفظ وأعد تشغيل Claude Desktop.

5. التحقق:
   ابدأ محادثة مع Claude واطرح سؤالاً حول بياناتك.

مع حساب الخدمة:

{
  "mcpServers": {
    "bigquery": {
      "command": "npx",
      "args": [
        "-y",
        "@ergut/mcp-bigquery-server",
        "--project-id",
        "your-project-id",
        "--location",
        "us-central1",
        "--key-file",
        "/path/to/your/service-account-key.json"
      ]
    }
  }
}

تأمين مفاتيح API:
قم بتخزين مفتاح حساب الخدمة خارج المستودع وأشر إليه باستخدام معلمة --key-file. لا تقم أبداً بإضافة المفاتيح إلى نظام إدارة الإصدارات.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

رأينا

يقدم خادم BigQuery MCP حلاً مركزاً وآمناً وسهل الاستخدام لربط نماذج اللغة الكبيرة بمجموعات بيانات BigQuery. ومع ذلك، يفتقر المستودع حالياً إلى توثيق لقوالب المحفزات، وموارد MCP الصريحة، وتعريفات الأدوات، والتي من شأنها تعزيز قابلية التوسع والتكامل. الإعداد مباشر لمنصة Claude Desktop، لكن التعليمات للمنصات الأخرى (مثل Windsurf أو Cursor أو Cline) أو ميزات MCP المتقدمة (الجذور أو العيّنات) غير متوفرة. بشكل عام، هذا الخادم قوي في استخدامه الأساسي لكنه محدود في التوسع.

التقييم: 6/10 — ممتاز لوظيفته الأساسية، لكنه يفتقر إلى ميزات البروتوكول الأشمل والتوثيق.

درجة MCP