عن المشروع

مُستودع mcp-server-snowflake هو خادم مستقل الصيانة لبروتوكول سياق النموذج (MCP)، مرخص بتراخيص Apache-2.0، يتيح للمساعد الذكي العمل مع Snowflake. ويشير المشروع إلى أنه غير تابع لشركة Snowflake Inc. أو مولّى أو روعٍ منه أو مدعوم من قِبلها، ويذكر أن علامتي "Snowflake" و"Cortex" هما علامات تجارية مسجلة لشركة Snowflake Inc. يتم توزيعه على PyPI ويمكن تثبيته باستخدام uv أو pip، ويعمل عبر معالج إعداد (--init)، أو يُوجّه نحو اتصال مُعرّف في وحدة تحكم Snowflake CLI (-c)، أو يُشغّل داخل حاوية Docker. الروابط وحلالات الاتصال: يمكن للخادم قراءة تكوين Snowflake CLI من ملف ~/.snowflake/connections.toml لاستخدام الملف الشخصي الحالي دون إعدادات إضافية. ويدعم التبديل بين الملفات الشخصية أثناء التشغيل عبر أداة snowflake_use_connection، وتهيئتها بقائمة snowflake_list_connections. وتشمل خيارات المصادقة رموز الوصول البرمجية أو OAuth (الرمز موجود في ملف تعريف الاتصال أو متغير البيئة SNOWFLAKE_TOKEN)، ومفتاح RSA ثنائي مع JWT (مسار المفتاح الخاص SNOWFLAKE_PRIVATE_KEY_PATH، مع كلمة مرور اختيارية)، وتسجيل الدخول الموحد عبر مصادق externalbrowser، والمتغيرات البيئية القياسية مثل الحساب والمستخدم وكلمة المرور والمستودع وقاعدة البيانات والمخطط والدور. ضوابط السلامة: يتضمن الوضع القراء فقط (SNOWFLAKE_MCP_READONLY=1 أو --readonly) تعطيل أدوات تعديل DDL/DML، كما تتطلب العمليات المدمّرة مثل حذف قواعد البيانات أو المخططات أو الجداول تأكيدًا صريحًا عبر confirm=True. وتُستخدم الحدود الافتراضية لعدد الصفوف ومتوسط المهلة الزمنية (SNOWFLAKE_MAX_ROWS=1000 وSNOWFLAKE_QUERY_TIMEOUT=120) للتحكم في أحجام النتائج. تغطية الأدوات: يجمع الدليل 140 أداة ضمن 19 وحدة مجال، تشمل استعلامات SQL والمعاملات query وDML والإلغاء وسجل الاستعلامات وخطة الاستعلام وإحصاءات المشغّل وبدء الإغلاق وإلغاؤه؛ وقواعد البيانات والمخططات والجداول والViews مع إمكانية العرض والوصف والإنشاء والحذف والنسخ الاحتياطي وإعادة الاسترداد والDDL وأخذ العينات والمسح؛ والمستودعات الافتراضية List/وصف/إنشاء/حذف/استئناف/تعليق/resize وتاريخ التحميل؛ ومرافق التخزين stages والعملياتFile; والمهام pipelines DAG; والestreams واحتجاز التغييرات؛ والجداول الديناميكية وIceberg مع volumes خارجية وتكاملات catalog؛ واستخراج Snowpipe؛ والتنبيهات والإشعارات؛ والحوكمة وRBAC والأدوار والمستخدمين؛ وسياسات الشبكة وكلمات المرور؛ ومجموعات حساب SPCS وStreamlit؛ وobject tags والتصنيفات؛ وتوريث Horizon مع سياسات القناع وصول الصفوف؛ وobject programmability بما فيها إجراءات functions وsecrets وsequences وintegrations وevent tables؛ وhelpers Cortex AI للإكمال والتلخيص وتحليل المشاعر واستخراج الإجابات والترجمة والبحث والتضمين النصي واستفسارات المحلل؛ وسيرورات composite مثل checks وصيانة الفحص inspecting profiling وscale warehouse cloning recipes export to stage and account usage summaries schema lineage discovery. الجمهور المستهدف: مهندسو البيانات والمحليون وفريقون المنصة الذين يريدون مساعد ذكي لفحص وإدارة حسابات Snowflake عبر MCP، مع وجود ضوابط تسمح بالوضع القراء أو الاستخدام المعتمد على التأكيد. وتُظهر شارات المستودع حالة الترخيص واختبارات CI وإصدار PyPI وتغطية الأدوات.