/ الدليل / الملعب / Google Cloud Run
← كل الخوادم ↗ GitHub
● رسمي GoogleCloudPlatform 🔑 يتطلب مفتاحك

Google Cloud Run

بواسطة GoogleCloudPlatform · GoogleCloudPlatform/cloud-run-mcp

نشر وإدارة خدمات Google Cloud Run من وكيل — MCP رسمي من Google، يعمل مع مصادقة gcloud.

MCP رسمي لمنصة Google Cloud Platform. نشر الحاويات أو محتوى الملفات إلى Cloud Run، إدراج وفحص الخدمات، سحب السجلات. يستخدم بيانات اعتماد gcloud التطبيق الافتراضية — بدون ملف JSON لحساب الخدمة في الإعدادات. الأفضل للعمليات النشر المدفوعة بالوكيل والاستعلامات عن السجلات أثناء التشخيص.

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

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

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

عرض مباشر

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

cloud-run.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "cloud-run",
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "cloud-run": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@google-cloud/cloud-run-mcp"
        ]
      }
    }
  }
}

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

claude mcp add cloud-run -- npx -y @google-cloud/cloud-run-mcp

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

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

استخدامات عملية: Google Cloud Run

نشر خدمة صغيرة إلى Cloud Run من الوكيل

👤 مهندسو الواجهة الخلفية، المؤسسون المنفردون الذين ينشرون نماذج أولية ⏱ ~10 min intermediate

متى تستخدمه: لديك خدمة Node/Python جاهزة. تريدها مباشرة على Cloud Run دون الحاجة إلى التبديل إلى لوحة التحكم.

المتطلبات الأساسية
  • تثبيت وتصديق gcloud SDK — gcloud auth login && gcloud auth application-default login
  • مشروع GCP مع تفعيل الفواتير — gcloud projects list
الخطوات
  1. قائمة المشاريع، اختر الصحيح
    قائمة مشاريعي في GCP. أريد النشر للمشروع الموسوم بـ 'staging'.✓ تم النسخ
    → تم تحديد المشروع
  2. نشر المجلد المحلي
    أنشر ./my-api كخدمة Cloud Run باسم 'api-staging' في us-central1. اسمح باستدعاءات غير مصرح بها. استخدم buildpack المكتشف تلقائياً.✓ تم النسخ
    → اكتمال النشر، تم إرجاع العنوان
  3. تحقق
    احصل على تفاصيل الخدمة. استدعِ العنوان باختبار نمط curl. أكد 200.✓ تم النسخ
    → عنوان خدمة عامل

النتيجة: خدمة Cloud Run قيد التشغيل في 3-5 دقائق، مع تسجيل الوكيل للعنوان لك.

المزالق
  • علم عدم المصادقة يكشف الخدمة للجمهور — ممتاز للتجريب، سيء للإنتاج — لأي شيء قريب من الإنتاج، أغفل allow_unauthenticated واستخدم IAM؛ ضع Cloud Armor أمامه إذا كان مواجهاً للمستخدم
  • كل نشر ينشئ مراجعة جديدة، القديمة تبقى وتثبت الموارد — قم بتنظيف المراجعات القديمة بشكل دوري باستخدام gcloud، أو قم بتكوين احتفاظ المراجعة
اجمعها مع: fastmcp · fastapi-mcp

تشخيص خدمة Cloud Run من سجلاتها

👤 مهندسون في الخدمة ⏱ ~10 min intermediate

متى تستخدمه: خدمة Cloud Run ترجع أخطاء 500. تريد رؤية السجلات دون فتح لوحة التحكم.

الخطوات
  1. سحب السجلات الحديثة
    احصل على آخر 200 إدخال سجل للخدمة 'api-prod' في us-central1. صفّي لخطورة ERROR.✓ تم النسخ
    → إدخالات سجل الأخطاء
  2. ابحث عن الأنماط
    اجمع الأخطاء حسب نموذج الرسالة. أيها الأكثر شيوعاً؟ أضف نموذج واحد من stacktrace.✓ تم النسخ
    → الخطأ الأعلى مع stacktrace
  3. اقترح العلاج
    بناءً على stacktrace، أشر إلى مسار الكود المحتمل. أوصِ بالتراجع إلى المراجعة السابقة إذا كانت الأخطاء متركزة في النشر الأخير.✓ تم النسخ
    → فرضية السبب الجذري + الإجراء

النتيجة: من التنبيه إلى قرار التراجع في 5 دقائق.

المزالق
  • احتفاظ السجل قصير افتراضياً (30 يوم) — لأي شيء قد تحتاج إلى النظر فيه لاحقاً، صدّر السجلات إلى BigQuery أو GCS عبر Log Router
اجمعها مع: sentry

نشر خادم MCP (FastMCP / fastapi-mcp) إلى Cloud Run

👤 مهندسو المنصة الذين يستضيفون MCPs مشتركة ⏱ ~30 min advanced

متى تستخدمه: بنيت خادم MCP وتريد استضافته لاستخدام الفريق بأكمله.

المتطلبات الأساسية
  • Dockerfile أو مشروع متوافق مع buildpack — Cloud Run يمكنه استخدام buildpacks لمعظم اللغات
الخطوات
  1. نشر الخادم
    أنشر ./my-mcp كخدمة Cloud Run 'acme-mcp'، منطقة us-central1. عيّن متغيرات البيئة من .env.prod. تطلب المصادقة.✓ تم النسخ
    → تم نشر الخدمة خلف IAM
  2. منح وصول IAM
    امنح دور 'roles/run.invoker' على هذه الخدمة لمجموعة [email protected].✓ تم النسخ
    → يمكن للفريق الآن الاستدعاء
  3. توصيل العملاء
    اكتب إعداد Claude Desktop الذي يتصل عبر gcloud run services proxy أو mcp-remote برمز IAM.✓ تم النسخ
    → الفريق لديه إعداد نسخ-لصق

النتيجة: MCP مستضافة من الفريق مع المصادقة الأصلية من GCP، نفس نموذج النشر لخدماتك الأخرى.

المزالق
  • اتصالات SSE تنقطع عند انتهاء صلاحية طلب Cloud Run الافتراضية (5 دقائق) — عيّن --timeout=3600 على الخدمة؛ اتصالات MCP تحتاج إلى تحمل انتظار أطول
اجمعها مع: fastmcp · fastapi-mcp · mcp-context-forge

التركيبات

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

cloud-run + fastmcp

اكتب MCP بـ Python، وأنشره إلى Cloud Run في جلسة واحدة

قم بتصميم خادم FastMCP يعرض API الأسعار الخاص بنا، ثم أنشره إلى خدمة Cloud Run 'pricing-mcp' مع مصادقة IAM.✓ تم النسخ
cloud-run + sentry

أخطاء Cloud Run → Sentry لفرز الحوادث

إذا ارتفع معدل الخطأ في خدمة Cloud Run، اسحب المشكلة المطابقة من Sentry وارتبط آثار المكدس بآخر نشر.✓ تم النسخ
cloud-run + mcp-context-forge

استضف ContextForge نفسه على Cloud Run لتجميع MCPs

أنشر mcp-contextforge-gateway إلى Cloud Run مع Redis لحالة الاتحاد. سجل MCPs الثلاثة الموجودة لدينا كنهايات خلفية.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list-projects اكتشف المشروع المراد استهدافه (محلي فقط) free
create-project name, project_id? إعداد مشروع GCP جديد (محلي فقط) free
list-services project, region? رؤية ما يعمل في مشروع/منطقة free
get-service project, region, service فحص إعداد خدمة معينة free
get-service-log project, region, service, filter?, limit? التصحيح — سحب السجلات الحديثة free
deploy-local-folder folder_path, service, region, project, allow_unauthenticated? نشر الكود الذي لديك محلياً (محلي فقط) free (build) + per-request Cloud Run pricing
deploy-file-contents files: {path,content}[], service, region, project نشر الكود المُنشأ بواسطة الوكيل دون ملفات محلية free (build) + per-request Cloud Run pricing

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

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

حصة API
حصص GCP — سخية لـ Cloud Run deploy API
الرموز لكل استدعاء
يمكن أن تكون استجابات السجل كبيرة — قم بالتصفح أو الترشيح بقوة
التكلفة المالية
Cloud Run: المستوى المجاني ~2M طلب/شهر، ثم ~$0.40 لكل مليون طلب + $0.000024 لكل vCPU-sec
نصيحة
عيّن min-instances=0 للخدمات غير الحرجة — البدايات الباردة تؤذي لكن التكلفة تنخفض إلى ما يقرب من الصفر في الخمول

الأمان

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

الحد الأدنى من الصلاحيات: roles/run.admin roles/iam.serviceAccountUser
تخزين بيانات الاعتماد: بيانات اعتماد التطبيق الافتراضي عبر gcloud auth application-default login — بدون ملفات مفاتيح
نقل البيانات الخارجي: استدعاءات إلى *.googleapis.com
لا تمنح أبدًا: roles/owner

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

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

Permission denied on deploy

حسابك يحتاج إلى roles/run.admin و roles/iam.serviceAccountUser على حساب خدمة وقت التشغيل. تحقق عبر gcloud projects get-iam-policy.

Build failed with 'buildpack not detected'

أضف Dockerfile، أو ملف يعترف به buildpacks (package.json لـ Node، requirements.txt لـ Python، إلخ).

Service deployed but returns 403

إما أن allow_unauthenticated لم يتم تعيينه، أو أن هويتك المستدعاة تفتقد roles/run.invoker. قرر: عام أم محمي بـ IAM.

SSE MCP connections hang / drop

زد --timeout=3600 وتأكد من min-instances=1 لتجنب قطع البدء البارد.

البدائل

Google Cloud Run مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Vercel (للتطبيقات Next.js)تستضيف تطبيق Next.js بشكل محددتجربة مطور أبسط للـ Next.js؛ أضيق من Cloud Run
AWS App Runner / Lambda MCPأنت على AWSنموذج بدون خادم قابل للمقارنة، نظام بيئي مختلف
Fly.ioتريد حافة عالمية بشكل افتراضي وأسعار أبسطنظام بيئي أصغر؛ لا MCP رسمي حتى الآن

المزيد

الموارد

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

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

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