Gemini Cloud Assist

Máy chủ MCP Gemini Cloud Assist

[!IMPORTANT] Thông báo Xem trước Riêng tư Các API máy chủ MCP Gemini Cloud Assist hiện đang trong giai đoạn Xem trước Riêng tư và nằm sau danh sách cho phép. Vui lòng liên hệ với nhóm tài khoản Google Cloud của bạn để yêu cầu quyền truy cập.

[!WARNING] Thông báo Ngừng hỗ trợ & Di chuyển sang Máy chủ MCP Từ xa

Máy chủ MCP Gemini Cloud Assist đã di chuyển từ kiến trúc Node.js cục bộ sang kiến trúc Máy chủ MCP Từ xa. Máy chủ Node.js cục bộ cũ sẽ không còn được hỗ trợ trong những tháng tới.

Để sử dụng Máy chủ MCP Từ xa mới, vui lòng sử dụng phiên bản v0.8.0 trở lên. Nếu bạn muốn tiếp tục sử dụng máy chủ cục bộ kế thừa trong thời gian chuyển tiếp, vui lòng cố định cấu hình của bạn ở các phiên bản cũ hơn.

Máy chủ này kết nối các máy khách Giao thức Ngữ cảnh Mô hình (MCP) với API Gemini Cloud Assist. Nó cho phép bạn sử dụng ngôn ngữ tự nhiên để hiểu, quản lý và khắc phục sự cố môi trường Google Cloud của bạn trực tiếp từ dòng lệnh cục bộ.

[!NOTE] Điều khoản Dịch vụ Google Cloud Platform (có tại https://cloud.google.com/terms/) và Điều khoản Xử lý Dữ liệu và Bảo mật (có tại https://cloud.google.com/terms/data-processing-terms) không áp dụng cho bất kỳ thành phần nào của phần mềm Máy chủ MCP Gemini Cloud Assist.

Để tìm hiểu thêm về Gemini Cloud Assist, hãy xem Tổng quan về Gemini Cloud Assist trong tài liệu Google Cloud.

✨ Tính năng chính

• Thiết kế hạ tầng: Tạo và kiến trúc các cấu hình hạ tầng cho Google Cloud.
• Khắc phục sự cố: Chạy các cuộc điều tra chuyên sâu để tìm ra nguyên nhân gốc rễ của các vấn đề phức tạp trong môi trường Google Cloud của bạn.
• Quản lý tài nguyên: Tạo, cập nhật và xóa tài nguyên Google Cloud trực tiếp từ quy trình trò chuyện của bạn (yêu cầu Hành động Tác nhân).
• Tối ưu hóa chi phí: Phân tích chi tiêu của bạn, theo dõi chi phí và xác định các cơ hội nâng cao hiệu quả như tài nguyên nhàn rỗi.
• Nhận hỗ trợ chung: Đặt câu hỏi và nhận hướng dẫn về các phương pháp hay nhất, kiến trúc và vận hành Google Cloud.

Bắt đầu nhanh

Trước khi bắt đầu, hãy đảm bảo bạn đã thiết lập những điều sau:

• Google Cloud SDK được cài đặt và cấu hình.
• Một dự án Google Cloud.
• Các vai trò IAM sau trên tài khoản người dùng của bạn:
  • roles/serviceusage.serviceUsageAdmin: Bắt buộc để kích hoạt API Cloud Assist.
  • roles/geminicloudassist.user: Bắt buộc để gửi yêu cầu đến API Cloud Assist.

Bước 1: Xác thực với Google Cloud

Máy chủ MCP Gemini Cloud Assist sử dụng Thông tin xác thực mặc định của ứng dụng (ADC) cục bộ để xác thực an toàn với Google Cloud. Để thiết lập ADC, hãy chạy các lệnh gcloud sau:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

Cấu hình máy khách MCP của bạn

Cấu hình máy khách-tác nhân phụ thuộc vào tác nhân bạn đang sử dụng.

Antigravity

Thêm nội dung sau vào mcp_config.json của bạn:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. Trong dự án Google Cloud của bạn, hãy tạo ID máy khách OAuth 2.0 cho ứng dụng máy tính để bàn.
2. Cấu hình URI://anysphere.cursor-mcp/oauth/callback làm URL chuyển hướng.
3. Thêm hoặc hợp nhất khối cấu hình sau:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Làm theo hướng dẫn cấu hình cho ứng dụng cụ thể của bạn:

• Claude.ai

Công cụ MCP

Công cụ MCP Gemini Cloud Assist

Gemini Cloud Assist là một tác nhân có thể truy cập thông qua một bộ công cụ MCP. Tác nhân được gọi bởi các lệnh gọi công cụ MCP sẽ tự thực hiện các lệnh gọi công cụ nội bộ đến Google Cloud. Các công cụ MCP sau được xuất bản để các tác nhân sử dụng:

Công cụ	Mô tả
ask_cloud_assist	Giao diện chính cho hỗ trợ Google Cloud và cho tác nhân Gemini Cloud Assist. Tất cả chức năng đều có thể truy cập thông qua công cụ này.
design_infra	Hỗ trợ quy trình làm việc để thiết kế và kiến trúc hạ tầng trên Google Cloud.
investigate_issue	Hỗ trợ quy trình làm việc để khắc phục sự cố trong Google Cloud. Có thể khắc phục sự cố nhanh hoặc khắc phục sự cố sâu hơn thông qua tài nguyên Điều tra.
invoke_operation	Hỗ trợ quy trình làm việc để tạo, cập nhật và xóa tài nguyên trong Google Cloud. Chỉ hoạt động khi Hành động Tác nhân được bật.
optimize_costs	Hỗ trợ quy trình làm việc để phân tích, theo dõi và tối ưu hóa chi phí Google Cloud. Cung cấp phân tích chi tiêu và xác định các cơ hội nâng cao hiệu quả chi phí.

Công cụ MCP Trung tâm Thiết kế Ứng dụng

Các công cụ MCP Trung tâm Thiết kế Ứng dụng, thường được điều phối bởi công cụ design_infra của GCA, quản lý vòng đời ứng dụng hạ tầng bằng Trung tâm Thiết kế Ứng dụng, bao gồm quản lý mẫu, tuân thủ và khắc phục bảo mật cũng như triển khai.

Công cụ	Mô tả
setup_adc	Khởi tạo môi trường Trung tâm Thiết kế Ứng dụng. Đây là bước thiết lập một lần phải được thực hiện trước khi các công cụ ADC khác có thể được sử dụng.
manage_application	Quản lý vòng đời triển khai của một ứng dụng. Sử dụng công cụ này để triển khai một thiết kế đã được xác minh bằng Trung tâm Thiết kế Ứng dụng hoặc truy xuất trạng thái và chi tiết của một bản triển khai hiện có. Đây là bước cuối cùng biến thiết kế của bạn thành hạ tầng được triển khai trên Google Cloud.
manage_application_template	Quản lý nội dung Hạ tầng dưới dạng Mã (IaC) của thiết kế hạ tầng của bạn. Sử dụng công cụ này để lưu thiết kế dưới dạng mẫu Trung tâm Thiết kế Ứng dụng, xuất thiết kế dưới dạng tệp Terraform hoặc cập nhật thiết kế (ví dụ: thành phần, cấu hình tham số, v.v.).
assess_best_practices	Thực hiện kiểm tra bảo mật và cấu hình toàn diện trên thiết kế ứng dụng của bạn trước khi triển khai. Công cụ này xác thực thiết kế theo các khung và kiểm soát liên quan của Trung tâm Chỉ huy Bảo mật, trả về báo cáo với các phát hiện có thể hành động để khắc phục.
list_application_templates	Liệt kê tất cả các thiết kế ứng dụng có sẵn.

Lưu ý: Các công cụ này không nên được coi là API ổn định. Các tham số có thể được đổi tên hoặc sửa đổi để phù hợp với khả năng đang phát triển của Gemini Cloud Assist.

Kỹ năng Tác nhân

Các công cụ MCP Gemini Cloud Assist tận dụng các tệp SKILL.md để hướng dẫn tác nhân của bạn cách sử dụng các công cụ một cách chính xác. Các kỹ năng giúp hướng dẫn tác nhân của bạn kết nối nhiều công cụ thành một quy trình làm việc, truyền thông tin cục bộ liên quan đến Gemini Cloud Assist và cho phép gọi rõ ràng.

Kỹ năng	Mô tả
designing-and-deploying-infrastructure	Hướng dẫn tác nhân cách thiết kế, đánh giá, triển khai và khắc phục sự cố hạ tầng đám mây bằng Trung tâm Thiết kế Ứng dụng (ADC) và các công cụ Gemini Cloud Assist.
operating-google-cloud	Cung cấp hướng dẫn để quản lý tài nguyên Google Cloud Platform (GCP) và Kubernetes bằng các công cụ MCP chuyên dụng.

Đóng góp

• Nếu bạn gặp lỗi, vui lòng ghi sự cố trên trang GitHub Issues của chúng tôi.
• Trước khi gửi yêu cầu kéo, vui lòng xem lại Hướng dẫn Đóng góp của chúng tôi.

Giấy phép

Dự án này được cấp phép theo Giấy phép Apache 2.0 và được cung cấp nguyên trạng, không có bảo hành hoặc đại diện cho bất kỳ mục đích sử dụng hoặc mục đích nào. Để biết chi tiết, hãy xem tệp LICENSE.