Google Cloud MCP

Máy chủ MCP gcloud ☁️

Máy chủ Model Context Protocol (MCP) gcloud cho phép các trợ lý AI dễ dàng tương tác với môi trường Google Cloud bằng cách sử dụng CLI gcloud. Với máy chủ MCP gcloud, bạn có thể:

• Tương tác với Google Cloud bằng ngôn ngữ tự nhiên. Mô tả kết quả bạn mong muốn thay vì phải ghi nhớ cú pháp, cờ và đối số phức tạp của lệnh.
• Tự động hóa và đơn giản hóa các quy trình phức tạp. Chuỗi nhiều thao tác đám mây thành một lệnh duy nhất, có thể lặp lại để giảm công sức thủ công và khả năng xảy ra lỗi.
• Hạ thấp rào cản gia nhập đối với quản lý đám mây. Trao quyền cho các thành viên trong nhóm ít quen thuộc với gcloud thực hiện các hành động mạnh mẽ một cách tự tin và an toàn.

📡 Các Máy chủ MCP Có sẵn

Kho lưu trữ này cũng lưu trữ các máy chủ MCP khác ngoài máy chủ MCP gcloud. Danh sách cập nhật ở bên dưới và các liên kết đến các máy chủ MCP Google Cloud khác được lưu trữ bên ngoài kho lưu trữ này có ở đây.

Tên Máy chủ MCP	Mô tả	Tên Gói	Phiên bản
gcloud	Tương tác với Google Cloud qua CLI gcloud bằng cách sử dụng lời nhắc ngôn ngữ tự nhiên.	gcloud-mcp
observability	Truy cập các API Google Cloud Observability để truy vấn nhật ký, chỉ số và dấu vết.	observability-mcp
storage	Tương tác với Google Cloud Storage để quản lý bucket và đối tượng.	storage-mcp
backupdr	Tương tác với Google Cloud Backup and Disaster Recovery.	backupdr-mcp

🚀 Bắt đầu

Điều kiện tiên quyết

• Node.js: phiên bản 20 trở lên
• CLI gcloud

✨ Thiết lập máy chủ MCP của bạn

Gemini CLI và Gemini Code Assist

Để tích hợp các máy chủ MCP với Gemini CLI hoặc Gemini Code Assist, hãy chạy lệnh thiết lập bên dưới từ thư mục chính của bạn cho máy chủ MCP được liệt kê trong bảng. Thao tác này sẽ cài đặt máy chủ MCP dưới dạng tiện ích mở rộng Gemini CLI cho người dùng hiện tại, giúp nó khả dụng cho tất cả các dự án của bạn.

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

Ví dụ: đối với gcloud-mcp:

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

Sau quá trình khởi tạo, bạn có thể xác minh rằng máy chủ gcloud-mcp được cấu hình chính xác bằng cách chạy lệnh sau:

gemini mcp list

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

Đối với các ứng dụng khách AI khác

Để sử dụng các máy chủ MCP trong kho lưu trữ này với các ứng dụng khách khác, hãy thêm đoạn mã sau vào tệp cấu hình JSON tương ứng của chúng cho mỗi máy chủ MCP:

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

Ví dụ: đối với gcloud:

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

Hướng dẫn cho các công cụ phổ biến:

• Claude Desktop: Mở Claude > Settings > Developer > Edit Config và chỉnh sửa claude_desktop_config.json.
• Cline: Nhấp vào biểu tượng MCP Servers, sau đó Configure MCP Servers để chỉnh sửa cline_mcp_settings.json.
• Cursor: Chỉnh sửa .cursor/mcp.json cho một dự án hoặc ~/.cursor/mcp.json cho tất cả các dự án.
• Gemini CLI (Thiết lập Thủ công): Nếu không sử dụng tiện ích mở rộng, chỉnh sửa .gemini/settings.json cho một dự án hoặc ~/.gemini/settings.json cho tất cả các dự án.

Đối với Visual Studio Code, chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc của bạn cho một dự án hoặc tệp cài đặt người dùng toàn cục cho tất cả các dự án:

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

Ví dụ: đối với gcloud và observability:

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

🛠 Phát triển Cục bộ

Để biết thêm thông tin về việc cài đặt kho lưu trữ cục bộ, vui lòng xem development.md

🧰 Các Công cụ MCP Có sẵn

Máy chủ MCP	Công cụ	Mô tả
gcloud	run_gcloud_command	Thực thi lệnh gcloud. Một số lệnh đã bị hạn chế thực thi bởi tác nhân. Xem Quyền MCP để biết thêm thông tin.
observability	list_log_entries	Liệt kê các mục nhật ký từ một dự án.
	list_log_names	Liệt kê tên nhật ký từ một dự án.
	list_buckets	Liệt kê các nhóm nhật ký từ một dự án.
	list_views	Liệt kê các chế độ xem nhật ký từ một dự án.
	list_sinks	Liệt kê các điểm thu nhật ký từ một dự án.
	list_log_scopes	Liệt kê các phạm vi nhật ký từ một dự án.
	list_metric_descriptors	Liệt kê các mô tả chỉ số cho một dự án.
	list_time_series	Liệt kê dữ liệu chuỗi thời gian cho một chỉ số nhất định.
	list_alert_policies	Liệt kê các chính sách cảnh báo trong một dự án.
	list_traces	Tìm kiếm dấu vết trong một dự án.
	get_trace	Lấy một dấu vết cụ thể theo id trong một dự án.
	list_group_stats	Liệt kê các nhóm lỗi cho một dự án.
storage	list_objects	Liệt kê các đối tượng trong một nhóm GCS.
	read_object_metadata	Đọc siêu dữ liệu toàn diện cho một đối tượng cụ thể.
	read_object_content	Đọc nội dung của một đối tượng cụ thể.
	delete_object	Xóa một đối tượng cụ thể khỏi một nhóm.
	write_object	Ghi một đối tượng mới vào một nhóm.
	update_object_metadata	Cập nhật siêu dữ liệu tùy chỉnh của một đối tượng hiện có.
	copy_object	Sao chép một đối tượng từ nhóm này sang nhóm khác.
	move_object	Di chuyển một đối tượng từ nhóm này sang nhóm khác.
	upload_object	Tải tệp lên một nhóm GCS.
	download_object	Tải một đối tượng từ GCS xuống tệp cục bộ.
	list_buckets	Liệt kê tất cả các nhóm trong một dự án.
	create_bucket	Tạo một nhóm mới.
	delete_bucket	Xóa một nhóm.
	get_bucket_metadata	Lấy siêu dữ liệu toàn diện cho một nhóm cụ thể.
	update_bucket_labels	Cập nhật nhãn cho một nhóm.
	get_bucket_location	Lấy vị trí của một nhóm.
	view_iam_policy	Xem chính sách IAM cho một nhóm.
	check_iam_permissions	Kiểm tra quyền IAM cho một nhóm.
	get_metadata_table_schema	Kiểm tra xem dịch vụ thông tin chi tiết GCS có được bật hay không và trả về lược đồ bảng BigQuery cho một cấu hình tập dữ liệu thông tin chi tiết nhất định.
	execute_insights_query	Thực thi truy vấn BigQuery SQL đối với một tập dữ liệu thông tin chi tiết và trả về kết quả.
	list_insights_configs	Liệt kê tên của tất cả các cấu hình tập dữ liệu Storage Insights cho một dự án nhất định.
backupdr	list_backup_vaults	Liệt kê tất cả các kho lưu trữ sao lưu trong một dự án và vị trí nhất định.
	get_backup_vault	Lấy chi tiết của một kho lưu trữ sao lưu cụ thể.
	list_backup_plans	Liệt kê tất cả các kế hoạch sao lưu trong một dự án và vị trí nhất định.
	get_backup_plan	Lấy chi tiết của một kế hoạch sao lưu cụ thể.
	list_backup_plan_associations	Liệt kê tất cả các liên kết giữa kế hoạch sao lưu và tài nguyên.
	get_backup_plan_association	Lấy chi tiết của một liên kết kế hoạch sao lưu cụ thể.
	list_datasources	Liệt kê tất cả các nguồn dữ liệu trong một kho lưu trữ sao lưu.
	get_datasource	Lấy chi tiết của một nguồn dữ liệu cụ thể.
	list_backups	Liệt kê tất cả các bản sao lưu cho một nguồn dữ liệu nhất định.
	get_backup	Lấy chi tiết của một bản sao lưu cụ thể.
	find_protectable_resources	Khám phá các tài nguyên (VM, Đĩa, SQL) có thể được bảo vệ.
	get_backupdr_operation	Truy xuất trạng thái của một hoạt động BackupDR đang chạy dài.
	get_csql_operation	Truy xuất trạng thái của một hoạt động Cloud SQL đang chạy dài.
	create_backup_vault	Tạo một kho lưu trữ sao lưu mới trong một vị trí được chỉ định.
	create_backup_plan	Tạo một kế hoạch sao lưu mới với các quy tắc và thời gian lưu trữ đã xác định.
	update_backup_plan	Sửa đổi một kế hoạch sao lưu hiện có.
	create_backup_plan_association	Liên kết một tài nguyên với một kế hoạch sao lưu để bắt đầu bảo vệ.
	restore_backup	Khôi phục bản sao lưu vào một phiên bản hoặc đĩa Compute Engine đích.
	csql_restore	Khôi phục bản sao lưu Cloud SQL vào một phiên bản đích.
	delete_backup_vault	Xóa một kho lưu trữ sao lưu.
	delete_backup_plan	Xóa một kế hoạch sao lưu.
	delete_backup_plan_association	Gỡ bỏ bảo vệ khỏi một tài nguyên bằng cách xóa liên kết của nó.
	delete_backup	Xóa một bản sao lưu cụ thể khỏi kho lưu trữ.

🔑 Quyền của MCP

Quyền của gcloud MCP được liên kết trực tiếp với quyền của tài khoản gcloud đang hoạt động. Để hạn chế quyền và vận hành theo nguyên tắc đặc quyền tối thiểu, bạn có thể ủy quyền dưới dạng tài khoản dịch vụ bằng cách mạo danh và gán cho tài khoản dịch vụ một vai trò có quyền hạn chế.

Theo mặc định, gcloud MCP ngăn chặn việc thực thi các lệnh gcloud không phù hợp với tác nhân AI. Điều này nhằm hạn chế các lệnh có thể chạy đầu vào tùy ý và khởi tạo phiên tương tác. Xem tại đây để biết danh sách các lệnh bị từ chối.

💫 Các Máy chủ MCP khác của Google Cloud

Google Cloud cung cấp các máy chủ khác sau:

• 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 cho Cơ sở dữ liệu

👥 Đóng góp

Chúng tôi hoan nghênh mọi đóng góp! Cho dù bạn đang sửa lỗi, chia sẻ phản hồi hay cải thiện tài liệu, đóng góp của bạn đều được chào đón. Vui lòng đọc Hướng dẫn Đóng góp để bắt đầu.

📄 Lưu ý Quan trọng

Kho lưu trữ này hiện đang trong giai đoạn xem trước và có thể có những thay đổi gây hỏng. Kho lưu trữ này cung cấp một giải pháp, không phải là sản phẩm được Google hỗ trợ chính thức. Nó không được bảo hiểm theo Điều khoản Dịch vụ của Google Cloud. Nó có thể bị hỏng khi đặc tả MCP, các SDK khác, hoặc khi các giải pháp và sản phẩm khác thay đổi. Xem thêm Chính sách Bảo mật của chúng tôi.