Google Cloud MCP

आधिकारिक

Google Cloud सेवाओं के साथ इंटरैक्ट करें और अपने क्लाउड संसाधनों का प्रबंधन करें।

Google Cloud MCP के साथ आप क्या कर सकते हैं?

  • gcloud CLI कमांड चलाएँ — अपने AI को run_gcloud_command के माध्यम से किसी भी अनुमत gcloud कमांड को निष्पादित करने के लिए कहें, ताकि Google Cloud संसाधनों का प्रबंधन किया जा सके।
  • Cloud Observability डेटा क्वेरी करेंlist_log_entries, list_time_series, और list_traces जैसे टूल का उपयोग करके लॉग, मीट्रिक, ट्रेस और अलर्ट नीतियाँ प्राप्त करें।
  • Cloud Storage बकेट और ऑब्जेक्ट प्रबंधित करेंstorage-mcp टूल के साथ ऑब्जेक्ट और बकेट को सूचीबद्ध करें, बनाएँ, हटाएँ, कॉपी करें, स्थानांतरित करें, अपलोड करें या डाउनलोड करें।
  • Storage Insights का निरीक्षण करेंexecute_insights_query के साथ इनसाइट्स कॉन्फ़िगरेशन जाँचें और Storage Insights डेटासेट के विरुद्ध BigQuery क्वेरी चलाएँ।
  • बैकअप और DR संचालन को व्यवस्थित करेंbackupdr-mcp टूल का उपयोग करके बैकअप वॉल्ट और योजनाएँ बनाएँ, संसाधनों को संबद्ध करें, बैकअप सूचीबद्ध करें और पुनर्स्थापना ट्रिगर करें।

दस्तावेज़

gcloud-mcp Servers CI License

gcloud MCP सर्वर ☁️

gcloud मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर AI सहायकों को gcloud CLI का उपयोग करके Google Cloud परिवेश के साथ आसानी से सहभागिता करने में सक्षम बनाता है। gcloud MCP सर्वर के साथ आप यह कर सकते हैं:

  • प्राकृतिक भाषा का उपयोग करके Google Cloud के साथ सहभागिता करें। जटिल कमांड सिंटैक्स, फ़्लैग और तर्कों को याद रखने के बजाय अपने इच्छित परिणाम का वर्णन करें।
  • जटिल वर्कफ़्लो को स्वचालित और सरल बनाएँ। मैन्युअल प्रयास और त्रुटि की संभावना को कम करने के लिए एकाधिक क्लाउड संचालनों को एकल, दोहराने योग्य कमांड में श्रृंखलाबद्ध करें।
  • क्लाउड प्रबंधन में प्रवेश की बाधा को कम करें। टीम के उन सदस्यों को सशक्त बनाएँ जो gcloud से कम परिचित हैं, ताकि वे आत्मविश्वास और सुरक्षा के साथ शक्तिशाली कार्य कर सकें।

📡 उपलब्ध MCP सर्वर

यह रिपॉजिटरी gcloud MCP सर्वर के अतिरिक्त अन्य MCP सर्वर भी होस्ट करती है। नीचे अद्यतन सूची दी गई है, और इस रिपो के बाहर होस्ट किए गए अन्य Google Cloud MCP सर्वरों के लिंक यहाँ हैं।

MCP सर्वर का नामविवरणपैकेज का नामसंस्करण
gcloudप्राकृतिक भाषा संकेतों का उपयोग करके gcloud CLI के माध्यम से Google Cloud के साथ सहभागिता करें।gcloud-mcpVersion
observabilityलॉग, मीट्रिक और ट्रेस क्वेरी करने के लिए Google Cloud Observability API तक पहुँचें।observability-mcpVersion
storageबकेट और ऑब्जेक्ट प्रबंधन के लिए Google Cloud Storage के साथ सहभागिता करें।storage-mcpVersion
backupdrGoogle Cloud बैकअप और आपदा पुनर्प्राप्ति के साथ सहभागिता करें।backupdr-mcpVersion

🚀 आरंभ करना

पूर्वापेक्षाएँ

✨ अपना MCP सर्वर सेट अप करें

Gemini CLI और Gemini Code Assist

MCP सर्वरों को Gemini CLI या Gemini Code Assist के साथ एकीकृत करने के लिए, तालिका में सूचीबद्ध MCP सर्वर के लिए अपनी होम निर्देशिका से नीचे दिया गया सेटअप कमांड चलाएँ। यह MCP सर्वर को वर्तमान उपयोगकर्ता के लिए Gemini CLI एक्सटेंशन के रूप में स्थापित करेगा, जिससे यह आपकी सभी परियोजनाओं के लिए उपलब्ध हो जाएगा।

npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli

उदाहरण के लिए, gcloud-mcp के लिए:

npx @google-cloud/gcloud-mcp init --agent=gemini-cli

आरंभीकरण प्रक्रिया के बाद, आप निम्न कमांड चलाकर सत्यापित कर सकते हैं कि gcloud-mcp सर्वर सही ढंग से कॉन्फ़िगर किया गया है:

gemini mcp list

> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected

अन्य AI क्लाइंट के लिए

इस रिपो में MCP सर्वरों का उपयोग अन्य क्लाइंट के साथ करने के लिए, प्रत्येक MCP सर्वर के लिए उनकी संबंधित JSON कॉन्फ़िगरेशन फ़ाइलों में निम्नलिखित स्निपेट जोड़ें:

"[SERVER_NAME]": {
  "command": "npx",
  "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
}

उदाहरण के लिए, gcloud के लिए:

"gcloud": {
  "command": "npx",
  "args": ["-y", "@google-cloud/gcloud-mcp"]
}

लोकप्रिय टूल के लिए निर्देश:

  • Claude Desktop: Claude > Settings > Developer > Edit Config खोलें और claude_desktop_config.json संपादित करें।
  • Cline: MCP सर्वर आइकन पर क्लिक करें, फिर cline_mcp_settings.json संपादित करने के लिए Configure MCP Servers पर क्लिक करें।
  • Cursor: एकल परियोजना के लिए .cursor/mcp.json या सभी परियोजनाओं के लिए ~/.cursor/mcp.json संपादित करें।
  • Gemini CLI (मैन्युअल सेटअप): यदि एक्सटेंशन का उपयोग नहीं कर रहे हैं, एकल परियोजना के लिए .gemini/settings.json या सभी परियोजनाओं के लिए ~/.gemini/settings.json संपादित करें।

Visual Studio Code के लिए एकल परियोजना के लिए अपने कार्यक्षेत्र में .vscode/mcp.json फ़ाइल या सभी परियोजनाओं के लिए अपनी वैश्विक उपयोगकर्ता सेटिंग फ़ाइल संपादित करें:

"servers": {
  "[SERVER_NAME]": {
    "command": "npx",
    "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
  }
}

उदाहरण के लिए, gcloud और observability के लिए:

"servers": {
  "gcloud": {
    "command": "npx",
    "args": ["-y", "@google-cloud/gcloud-mcp"]
  },
  "observability": {
    "command": "npx",
    "args": ["-y", "@google-cloud/observability-mcp"]
  },
}

🛠 स्थानीय विकास

रिपॉजिटरी को स्थानीय रूप से स्थापित करने के बारे में अधिक जानकारी के लिए, कृपया development.md देखें

🧰 उपलब्ध MCP टूल

MCP सर्वरटूलविवरण
gcloudrun_gcloud_commandएक gcloud कमांड निष्पादित करता है। एजेंट द्वारा कुछ कमांड के निष्पादन पर प्रतिबंध लगाया गया है। अधिक जानकारी के लिए MCP अनुमतियाँ देखें।
observabilitylist_log_entriesकिसी प्रोजेक्ट से लॉग प्रविष्टियों की सूची बनाता है।
list_log_namesकिसी प्रोजेक्ट से लॉग नामों की सूची बनाता है।
list_bucketsकिसी प्रोजेक्ट से लॉग बकेट की सूची बनाता है।
list_viewsकिसी प्रोजेक्ट से लॉग व्यू की सूची बनाता है।
list_sinksकिसी प्रोजेक्ट से लॉग सिंक की सूची बनाता है।
list_log_scopesकिसी प्रोजेक्ट से लॉग स्कोप की सूची बनाता है।
list_metric_descriptorsकिसी प्रोजेक्ट के लिए मीट्रिक डिस्क्रिप्टर की सूची बनाता है।
list_time_seriesकिसी दिए गए मीट्रिक के लिए समय श्रृंखला डेटा की सूची बनाता है।
list_alert_policiesकिसी प्रोजेक्ट में अलर्ट नीतियों की सूची बनाता है।
list_tracesकिसी प्रोजेक्ट में ट्रेसेस खोजता है।
get_traceकिसी प्रोजेक्ट में आईडी द्वारा एक विशिष्ट ट्रेस प्राप्त करता है।
list_group_statsकिसी प्रोजेक्ट के लिए त्रुटि समूहों की सूची बनाता है।
storagelist_objectsGCS बकेट में ऑब्जेक्ट की सूची बनाता है।
read_object_metadataकिसी विशिष्ट ऑब्जेक्ट के लिए विस्तृत मेटाडेटा पढ़ता है।
read_object_contentकिसी विशिष्ट ऑब्जेक्ट की सामग्री पढ़ता है।
delete_objectकिसी बकेट से एक विशिष्ट ऑब्जेक्ट हटाता है।
write_objectकिसी बकेट में एक नया ऑब्जेक्ट लिखता है।
update_object_metadataकिसी मौजूदा ऑब्जेक्ट के कस्टम मेटाडेटा को अपडेट करता है।
copy_objectएक ऑब्जेक्ट को एक बकेट से दूसरे बकेट में कॉपी करता है।
move_objectएक ऑब्जेक्ट को एक बकेट से दूसरे बकेट में स्थानांतरित करता है।
upload_objectGCS बकेट में एक फ़ाइल अपलोड करता है।
download_objectGCS से एक स्थानीय फ़ाइल में ऑब्जेक्ट डाउनलोड करता है।
list_bucketsकिसी प्रोजेक्ट में सभी बकेट की सूची बनाता है।
create_bucketएक नया बकेट बनाता है।
delete_bucketएक बकेट हटाता है।
get_bucket_metadataकिसी विशिष्ट बकेट के लिए विस्तृत मेटाडेटा प्राप्त करता है।
update_bucket_labelsकिसी बकेट के लेबल अपडेट करता है।
get_bucket_locationकिसी बकेट का स्थान प्राप्त करता है।
view_iam_policyकिसी बकेट के लिए IAM नीति देखता है।
check_iam_permissionsकिसी बकेट के लिए IAM अनुमतियों का परीक्षण करता है।
get_metadata_table_schemaजाँचता है कि GCS इनसाइट्स सेवा सक्षम है या नहीं और किसी दिए गए इनसाइट्स डेटासेट कॉन्फ़िगरेशन के लिए BigQuery तालिका स्कीमा लौटाता है।
execute_insights_queryकिसी इनसाइट्स डेटासेट के विरुद्ध BigQuery SQL क्वेरी निष्पादित करता है और परिणाम लौटाता है।
list_insights_configsकिसी दिए गए प्रोजेक्ट के लिए सभी Storage इनसाइट्स डेटासेट कॉन्फ़िगरेशन के नामों की सूची बनाता है।
backupdrlist_backup_vaultsकिसी दिए गए प्रोजेक्ट और स्थान में सभी बैकअप वॉल्ट की सूची बनाता है।
get_backup_vaultकिसी विशिष्ट बैकअप वॉल्ट का विवरण प्राप्त करता है।
list_backup_plansकिसी दिए गए प्रोजेक्ट और स्थान में सभी बैकअप योजनाओं की सूची बनाता है।
get_backup_planकिसी विशिष्ट बैकअप योजना का विवरण प्राप्त करता है।
list_backup_plan_associationsबैकअप योजनाओं और संसाधनों के बीच सभी संबद्धताओं की सूची बनाता है।
get_backup_plan_associationकिसी विशिष्ट बैकअप योजना संबद्धता का विवरण प्राप्त करता है।
list_datasourcesबैकअप वॉल्ट के भीतर सभी डेटा स्रोतों की सूची बनाता है।
get_datasourceकिसी विशिष्ट डेटा स्रोत का विवरण प्राप्त करता है।
list_backupsकिसी दिए गए डेटा स्रोत के लिए सभी बैकअप की सूची बनाता है।
get_backupकिसी विशिष्ट बैकअप का विवरण प्राप्त करता है।
find_protectable_resourcesउन संसाधनों (VM, डिस्क, SQL) की खोज करता है जिन्हें संरक्षित किया जा सकता है।
get_backupdr_operationकिसी लंबे समय से चल रहे BackupDR ऑपरेशन की स्थिति प्राप्त करता है।
get_csql_operationकिसी लंबे समय से चल रहे Cloud SQL ऑपरेशन की स्थिति प्राप्त करता है।
create_backup_vaultकिसी निर्दिष्ट स्थान में एक नया बैकअप वॉल्ट बनाता है।
create_backup_planपरिभाषित नियमों और अवधारण के साथ एक नई बैकअप योजना बनाता है।
update_backup_planकिसी मौजूदा बैकअप योजना को संशोधित करता है।
create_backup_plan_associationसुरक्षा शुरू करने के लिए किसी संसाधन को बैकअप योजना से संबद्ध करता है।
restore_backupकिसी बैकअप को लक्षित Compute Engine इंस्टेंस या डिस्क पर पुनर्स्थापित करता है।
csql_restoreCloud SQL बैकअप को लक्षित इंस्टेंस पर पुनर्स्थापित करता है।
delete_backup_vaultबैकअप वॉल्ट को हटाता है।
delete_backup_planबैकअप योजना को हटाता है।
delete_backup_plan_associationकिसी संसाधन से उसकी संबद्धता हटाकर सुरक्षा समाप्त करता है।

🔑 MCP अनुमतियाँ

gcloud MCP की अनुमतियाँ सक्रिय gcloud खाते की अनुमतियों से सीधे जुड़ी होती हैं। अनुमतियों को प्रतिबंधित करने और न्यूनतम विशेषाधिकार के सिद्धांत के साथ संचालित करने के लिए, आप प्रतिरूपण का उपयोग करके सेवा खाते के रूप में अधिकृत कर सकते हैं और सेवा खाते को सीमित अनुमतियों वाली भूमिका असाइन कर सकते हैं।

डिफ़ॉल्ट रूप से, gcloud MCP उन gcloud कमांड के निष्पादन को रोकता है जो AI एजेंटों के लिए उपयुक्त नहीं हैं। यह उन कमांड को प्रतिबंधित करने के लिए किया जाता है जो मनमाने इनपुट चला सकते हैं और इंटरैक्टिव सत्र आरंभ कर सकते हैं। अस्वीकृत कमांड की सूची के लिए यहाँ देखें।

💫 अन्य Google Cloud MCP सर्वर

Google Cloud ये अन्य सर्वर प्रदान करता है:

👥 योगदान

हम योगदान का स्वागत करते हैं! चाहे आप बग ठीक कर रहे हों, प्रतिक्रिया साझा कर रहे हों, या दस्तावेज़ीकरण में सुधार कर रहे हों, आपके योगदान का स्वागत है। आरंभ करने के लिए कृपया हमारी योगदान मार्गदर्शिका पढ़ें।

📄 महत्वपूर्ण नोट्स

यह रिपॉजिटरी वर्तमान में पूर्वावलोकन में है और इसमें ब्रेकिंग परिवर्तन देखने को मिल सकते हैं। यह रिपॉजिटरी एक समाधान प्रदान करती है, आधिकारिक रूप से समर्थित Google उत्पाद नहीं। यह Google Cloud सेवा की शर्तों के अंतर्गत कवर नहीं है। यह तब टूट सकता है जब MCP विनिर्देश, अन्य SDK, या जब अन्य समाधान और उत्पाद बदलते हैं। हमारी सुरक्षा नीति भी देखें।