Gemini Cloud Assist MCP Server

chính thức

Một máy chủ MCP kết nối với các API Gemini Cloud Assist, cho phép bạn quản lý và khắc phục sự cố môi trường Google Cloud của mình bằng ngôn ngữ tự nhiên.

GitHub

Tài liệu

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ẽ mất 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ộ cũ trong quá trình chuyển đổi, vui lòng ghim cấu hình của bạn vào các phiên bản cũ hơn.

Máy chủ này kết nối các máy khách Model Context Protocol (MCP) như Gemini CLI 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ụ của Google Cloud Platform (có sẵn tại https://cloud.google.com/terms/) và Điều khoản Xử lý và Bảo mật Dữ liệu (có sẵn 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ế cơ sở hạ tầng: Tạo và kiến trúc các cấu hình cơ sở hạ tầng cho Google Cloud.
Khắc phục sự cố: Chạy các cuộc điều tra sâu để tìm 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ơ hội 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à hoạt động của 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: Yêu cầu để kích hoạt API Cloud Assist.
- roles/geminicloudassist.user: Yêu cầu để thực hiện 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 Ứ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 tác nhân-máy khách phụ thuộc vào tác nhân bạn đang sử dụng.

Gemini CLI

Cài đặt máy chủ MCP như một tiện ích mở rộng Gemini CLI:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Ngoài ra, bạn có thể thêm cấu hình thủ công vào ~/.gemini/settings.json của mình:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

Antigravity

Thêm phần 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

Trong dự án Google Cloud của bạn, tạo một ID khách OAuth 2.0 cho ứng dụng máy tính để bàn.
Cấu hình URI://anysphere.cursor-mcp/oauth/callback làm URL chuyển hướng.
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 thực hiện các lệnh gọi công cụ nội bộ của riêng nó đến Google Cloud. Các công cụ MCP sau được công bố để 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 có thể truy cập thông qua công cụ này.
`design_infra`	Hỗ trợ quy trình thiết kế và kiến trúc cơ sở hạ tầng trên Google Cloud.
`investigate_issue`	Hỗ trợ quy trình khắc phục sự cố trong Google Cloud. Có thể khắc phục sự cố nhanh hoặc sâu hơn thông qua tài nguyên Điều tra.
`invoke_operation`	Hỗ trợ quy trình 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 kích hoạt.
`optimize_costs`	Hỗ trợ quy trình 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ơ hội tiết kiệm 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 cơ sở 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ủ bảo mật, khắc phục và 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 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 cơ sở hạ tầng được triển khai trên Google Cloud.
`manage_application_template`	Quản lý nội dung Cơ sở hạ tầng dưới dạng Mã (IaC) của thiết kế cơ sở hạ tầng của bạn. Sử dụng để 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. Nó xác thực thiết kế dựa trên các khung của Trung tâm Chỉ huy An ninh và các kiểm soát liên quan, 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 ý: Những 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 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ông cụ đúng cách. Các kỹ năng giúp hướng dẫn tác nhân của bạn cách kết hợp nhiều công cụ thành một luồng công 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ố cơ sở hạ tầng đám mây bằng các công cụ Trung tâm Thiết kế Ứng dụng (ADC) và 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 gửi vấn đề 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 như hiệ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.