/ الدليل / الملعب / mcp-bigquery-server
← كل الخوادم ↗ GitHub
● مجتمع ergut ⚡ فوري

mcp-bigquery-server

بواسطة ergut · ergut/mcp-bigquery-server

وصول آمن بالقراءة فقط إلى BigQuery باللغة الطبيعية من Claude — استكشاف المخطط، حدود الاستعلام، تقييدات حقول البيانات الشخصية — مع مصادقة حساب الخدمة.

mcp-bigquery-server هي MCP قائمة على Node توفر للنماذج اللغوية الكبيرة وصولاً آمناً للقراءة فقط إلى مجموعات بيانات BigQuery. تفرض حدود استعلام قابلة للتكوين على البايتات الممسوحة ضوئياً (الافتراضية 1GB)، وتدعم التقييدات على مستوى الحقول لبيانات PII/PHI، ويمكن تثبيتها عبر Smithery أو تكوينها يدوياً باستخدام بيانات اعتماد حساب الخدمة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

bigquery-server.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "bigquery-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-bigquery-server"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "bigquery-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-bigquery-server"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "bigquery-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-bigquery-server"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "bigquery-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-bigquery-server"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "bigquery-server",
      "command": "npx",
      "args": [
        "-y",
        "mcp-bigquery-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "bigquery-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-bigquery-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add bigquery-server -- npx -y mcp-bigquery-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: mcp-bigquery-server

الإجابة عن أسئلة المنتج والنمو من BigQuery دون كتابة SQL

👤 مديرو المنتجات ومحللو النمو ذوو المستودعات المدعومة بـ BQ ⏱ ~15 min intermediate

متى تستخدمه: لديك سؤال إجابته موجودة في جداول الأحداث في BQ.

المتطلبات الأساسية
  • حساب خدمة GCP مع BQ Data Viewer + Job User — IAM > إنشاء حساب خدمة؛ تحميل مفتاح JSON
الخطوات
  1. اكتشاف الجداول
    اعرض الجداول في مجموعة البيانات analytics. صف events وusers.✓ تم النسخ
    → الأنماط
  2. اطرح السؤال
    كم عدد المستخدمين الذين اشتركوا في مارس 2026 وأطلقوا حدث 'aha_moment' في غضون 7 أيام؟✓ تم النسخ
    → إجابة رقمية مع عرض SQL
  3. تحذير
    هناك أي تحفظات؟ المنطقة الزمنية، الحذف، المستخدمون الاختباريون؟✓ تم النسخ
    → تحفظات صريحة

النتيجة: إجابات في دقائق بدلاً من تذاكر فريق البيانات.

المزالق
  • تشغيل SELECT * على جدول حقائق ضخم يتجاوز حد المسح — قم دائماً بالتصفية حسب عمود التقسيم (غالباً _PARTITIONDATE)

السماح لمحلل أقل ثقة باستكشاف البيانات دون قراءة صفوف البيانات الشخصية

👤 فرق منصات البيانات ⏱ ~30 min advanced

متى تستخدمه: تريد فتح وصول BQ لعدد أكثر من الأشخاص عبر الدردشة دون أن يتمكن كل منهم من قراءة رسائل البريد الإلكتروني للعملاء.

الخطوات
  1. تكوين الحقول المقيدة
    أضف إدخال config.json يقيد الحقول users.email, users.phone, users.ssn. يمكن للوكيل فقط تجميعها، وليس اختيارها بشكل خام.✓ تم النسخ
    → التكوين في مكانه
  2. اختبر
    قم بتشغيل SELECT email FROM users LIMIT 10. تحقق من أنه محظور. ثم قم بتشغيل SELECT domain, COUNT(*) FROM users GROUP BY domain — تحقق من أنه يعمل.✓ تم النسخ
    → حجب القراءة الخام؛ السماح بالتجميع

النتيجة: تحليلات ذاتية الخدمة أكثر أماناً لعصر النماذج اللغوية الكبيرة.

المزالق
  • قد يؤدي الكشف عن الحقول بناءً على regex إلى تفويت SQL المستعار المعقد — الدفاع المتعدد الطبقات — استخدم أيضاً أمان مستوى الأعمدة في BQ / العروض المرخصة
اجمعها مع: gateway

تجميع ملخص مقاييس يومي تلقائياً من BQ

👤 مديرو المنتجات والمؤسسون ⏱ ~30 min intermediate

متى تستخدمه: تريد KPIs في Slack كل صباح بدون أداة BI.

الخطوات
  1. حدد المقاييس
    حدد الاستعلامات لـ: DAU، التسجيلات، الإيرادات، أفضل 3 أخطاء. كل منها مع أمس / متوسط 7 أيام.✓ تم النسخ
    → SQL لكل مقياس
  2. قم بالتشغيل والتنسيق
    قم بتشغيل الكل وتنسيقه كملخص جاهز لـ Slack. اشمل التغييرات الأسبوعية.✓ تم النسخ
    → رسالة جاهزة لـ Slack

النتيجة: مقاييس يومية بدون تكاليف BI المدارة.

اجمعها مع: notion

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

bigquery-server + notion

وثيقة KPI الأسبوعية

قم بتشغيل استعلامات KPI الأسبوعية الخاصة بي وإنشاء صفحة Notion في 'Metrics Weekly' مع النتائج + التعليقات.✓ تم النسخ
bigquery-server + gateway

وصول آمن للبيانات الشخصية عبر mcp-gateway + Presidio

ضع BigQuery MCP خلف mcp-gateway مع Presidio؛ تحقق من أن رسائل البريد الإلكتروني للعملاء تم تحريرها في النتائج.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_datasets الخطوة الأولى للتوجه free
list_tables dataset التنقل في مجموعة بيانات free
describe_table dataset, table قبل الاستعلام free
query sql: str, max_bytes?: int أداة القراءة الرئيسية؛ محدودة بـ 1GB مسح افتراضياً BQ on-demand: $6.25 per TB scanned

التكلفة والحدود

تكلفة التشغيل

حصة API
حصص وظائف BigQuery (سخية)
الرموز لكل استدعاء
يمكن أن تكون نتائج الاستعلام ضخمة — استخدم دائماً LIMIT أو التجميع
التكلفة المالية
ادفع لـ GCP حسب البايتات الممسوحة ($6.25/TB عند الطلب). قم بتكوين حد المسح في MCP للتحديد.
نصيحة
قم بالتصفية حسب التقسيم. المسح الكامل للجدول على جدول حقائق مشغول = أموال حقيقية. حد البايتات في MCP هو شبكة الأمان الخاصة بك.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: bigquery.dataViewer + bigquery.jobUser على مجموعات البيانات المحددة فقط
تخزين بيانات الاعتماد: JSON حساب الخدمة في مسار مثبت؛ لا تقم بالالتزام أبداً
نقل البيانات الخارجي: نتائج الاستعلام تذهب إلى موفر LLM الخاص بك
لا تمنح أبدًا: dataOwner / dataEditor لحساب خدمة MCP

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

PERMISSION_DENIED on dataset

SA تفتقر إلى BQ Data Viewer. gcloud projects add-iam-policy-binding ....

تحقق: gcloud bigquery datasets list
Query exceeds configured byte limit

أضف مرشح تقسيم أو إسقاط عمود؛ أو رفع الحد إذا لزم الأمر بشكل مشروع.

Restricted field still appearing in results

قد لا يتطابق regex مع الأعمدة المستعارة — استخدم عروض BQ المرخصة للعزل الصارم.

البدائل

mcp-bigquery-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Looker / Metabaseتريد أداة BI وليس دردشةلوحات تحكم أفضل؛ أقل حواراً
postgres MCP via Cloud SQLبياناتك التحليلية موجودة في Postgres بدلاً من ذلكمحرك مختلف؛ Postgres لا يتسع مثل BQ للتجميعات الكبيرة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills