Google Cloud MCP Server

gcloud MCP Server ☁️

gcloud Model Context Protocol (MCP) เซิร์ฟเวอร์ช่วยให้ผู้ช่วย AI สามารถโต้ตอบกับสภาพแวดล้อม Google Cloud ได้อย่างง่ายดายโดยใช้ gcloud CLI ด้วย gcloud MCP server คุณสามารถ:

• โต้ตอบกับ Google Cloud โดยใช้ภาษาธรรมชาติ อธิบายผลลัพธ์ ที่คุณต้องการแทนการจดจำไวยากรณ์คำสั่ง แฟล็ก และอาร์กิวเมนต์ที่ซับซ้อน
• ทำให้เวิร์กโฟลว์ที่ซับซ้อนเป็นอัตโนมัติและง่ายขึ้น เชื่อมโยงการดำเนินการคลาวด์หลายรายการ เป็นคำสั่งเดียวที่ทำซ้ำได้เพื่อลดความพยายามด้วยตนเองและโอกาสเกิดข้อผิดพลาด
• ลดอุปสรรคในการเริ่มต้นจัดการคลาวด์ เพิ่มศักยภาพให้สมาชิกในทีม ที่ไม่คุ้นเคยกับ gcloud สามารถดำเนินการที่มีประสิทธิภาพได้อย่างมั่นใจและปลอดภัย

📡 MCP Servers ที่พร้อมใช้งาน

ที่เก็บนี้ยังโฮสต์ MCP server อื่นๆ นอกเหนือจาก gcloud MCP server รายการล่าสุดอยู่ด้านล่าง และลิงก์ไปยัง Google Cloud MCP server อื่นๆ ที่โฮสต์นอกที่เก็บนี้อยู่ ที่นี่

ชื่อ MCP Server	คำอธิบาย	ชื่อแพ็คเกจ	เวอร์ชัน
gcloud	โต้ตอบกับ Google Cloud ผ่าน gcloud CLI โดยใช้พรอมต์ภาษาธรรมชาติ	gcloud-mcp
observability	เข้าถึง Google Cloud Observability APIs เพื่อสอบถามล็อก เมตริก และเทรซ	observability-mcp
storage	โต้ตอบกับ Google Cloud Storage สำหรับการจัดการบัคเก็ตและออบเจกต์	storage-mcp
backupdr	โต้ตอบกับ Google Cloud Backup and Disaster Recovery	backupdr-mcp

🚀 เริ่มต้นใช้งาน

ข้อกำหนดเบื้องต้น

• Node.js: เวอร์ชัน 20 หรือสูงกว่า
• gcloud CLI

✨ ตั้งค่า MCP server ของคุณ

Gemini CLI และ Gemini Code Assist

เพื่อรวม MCP server เข้ากับ Gemini CLI หรือ Gemini Code Assist ให้รันคำสั่ง ตั้งค่าด้านล่างจากไดเรกทอรีบ้านของคุณสำหรับ MCP server ที่ระบุในตาราง นี้ จะติดตั้ง MCP server เป็น Gemini CLI extension สำหรับผู้ใช้ปัจจุบัน ทำให้พร้อมใช้งานสำหรับทุกโปรเจกต์ของคุณ

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

ตัวอย่างเช่น สำหรับ gcloud-mcp:

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

หลังจากกระบวนการเริ่มต้น คุณสามารถตรวจสอบว่า gcloud-mcp server ได้รับการกำหนดค่าอย่างถูกต้องโดยการรันคำสั่งต่อไปนี้:

gemini mcp list

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

สำหรับไคลเอนต์ AI อื่นๆ

ในการใช้ MCP server ในที่เก็บนี้กับไคลเอนต์อื่นๆ ให้เพิ่มสไนปเพ็ตต่อไปนี้ ลงในไฟล์การกำหนดค่า JSON ที่เกี่ยวข้องสำหรับแต่ละ MCP server:

"[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 Servers จากนั้น Configure MCP Servers เพื่อแก้ไข cline_mcp_settings.json
• 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 Tools ที่พร้อมใช้งาน

MCP Server	เครื่องมือ	คำอธิบาย
gcloud	run_gcloud_command	ดำเนินการคำสั่ง gcloud คำสั่งบางคำสั่งถูกจำกัดไม่ให้เอเจนต์ดำเนินการ ดูข้อมูลเพิ่มเติมที่ สิทธิ์ MCP
observability	list_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	รับเทรซเฉพาะตาม ID ในโปรเจกต์
	list_group_stats	แสดงรายการกลุ่มข้อผิดพลาดสำหรับโปรเจกต์
storage	list_objects	แสดงรายการออบเจกต์ในบัคเก็ต GCS
	read_object_metadata	อ่านข้อมูลเมตาดาต้าแบบครอบคลุมสำหรับออบเจกต์ที่ระบุ
	read_object_content	อ่านเนื้อหาของออบเจกต์ที่ระบุ
	delete_object	ลบออบเจกต์ที่ระบุออกจากบัคเก็ต
	write_object	เขียนออบเจกต์ใหม่ลงในบัคเก็ต
	update_object_metadata	อัปเดตข้อมูลเมตาดาต้าแบบกำหนดเองของออบเจกต์ที่มีอยู่
	copy_object	คัดลอกออบเจกต์จากบัคเก็ตหนึ่งไปยังอีกบัคเก็ตหนึ่ง
	move_object	ย้ายออบเจกต์จากบัคเก็ตหนึ่งไปยังอีกบัคเก็ตหนึ่ง
	upload_object	อัปโหลดไฟล์ไปยังบัคเก็ต GCS
	download_object	ดาวน์โหลดออบเจกต์จาก GCS ไปยังไฟล์ในเครื่อง
	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	ดำเนินการคิวรี SQL ของ BigQuery กับชุดข้อมูลข้อมูลเชิงลึกและส่งคืนผลลัพธ์
	list_insights_configs	แสดงรายชื่อของการกำหนดค่าชุดข้อมูล Storage Insights ทั้งหมดสำหรับโปรเจกต์ที่กำหนด
backupdr	list_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_restore	กู้คืนการสำรอง Cloud SQL ไปยังอินสแตนซ์เป้าหมาย
	delete_backup_vault	ลบ ห้องนิรภัยสำรอง
	delete_backup_plan	ลบ แผนสำรอง
	delete_backup_plan_association	ลบ การป้องกันออกจากทรัพยากรโดยการลบความสัมพันธ์
	delete_backup	ลบข้อมูลสำรองเฉพาะรายการออกจากคลังเก็บ

🔑 สิทธิ์ของ MCP

สิทธิ์ของ gcloud MCP เชื่อมโยงโดยตรงกับสิทธิ์ของบัญชี gcloud ที่ใช้งานอยู่ หากต้องการจำกัดสิทธิ์และดำเนินการตามหลักการให้สิทธิ์น้อยที่สุด คุณสามารถ อนุญาตเป็นบัญชีบริการโดยใช้การปลอมตัว และ กำหนดให้บัญชีบริการนั้นมี บทบาทที่มีสิทธิ์จำกัด

ตามค่าเริ่มต้น gcloud MCP จะป้องกันการเรียกใช้คำสั่ง gcloud ที่ไม่เหมาะสมสำหรับเอเจนต์ AI การดำเนินการนี้เพื่อจำกัดคำสั่งที่สามารถรับอินพุตตามอำเภอใจและเริ่มเซสชันแบบโต้ตอบได้ ดู ที่นี่ สำหรับรายการคำสั่งที่ถูกปฏิเสธ

💫 เซิร์ฟเวอร์ Google Cloud MCP อื่นๆ

Google Cloud มีเซิร์ฟเวอร์อื่นๆ ดังนี้:

• Firebase MCP
• Google Analytics MCP
• Google Cloud Genmedia MCP
• Google Cloud Run MCP
• Google Kubernetes Engine (GKE) MCP
• Google Security Operations and Threat Intelligence MCP
• MCP Toolbox สำหรับฐานข้อมูล

👥 การมีส่วนร่วม

เรายินดีต้อนรับการมีส่วนร่วม! ไม่ว่าคุณจะแก้ไขข้อบกพร่อง แบ่งปันความคิดเห็น หรือปรับปรุงเอกสาร เรายินดีรับการมีส่วนร่วมของคุณ โปรดอ่าน คู่มือการมีส่วนร่วม เพื่อเริ่มต้น

📄 หมายเหตุสำคัญ

ที่เก็บนี้อยู่ในช่วงพรีวิวและอาจมีการเปลี่ยนแปลงที่ส่งผลกระทบต่อความเข้ากันได้ ที่เก็บนี้เป็นโซลูชัน ไม่ใช่ผลิตภัณฑ์ที่ได้รับการสนับสนุนอย่างเป็นทางการจาก Google และไม่อยู่ภายใต้ ข้อกำหนดในการให้บริการของ Google Cloud อาจเกิดข้อผิดพลาดได้เมื่อข้อกำหนด MCP, SDK อื่นๆ หรือเมื่อโซลูชันและผลิตภัณฑ์อื่นๆ เปลี่ยนแปลง ดู นโยบายความปลอดภัย ของเราด้วย