Tích Hợp OCI-MCP: Kết Nối Oracle Cloud với AI

Tích hợp Oracle Cloud Infrastructure (OCI) với Giao thức Ngữ cảnh Mô hình (MCP) cho phép tương tác ngôn ngữ tự nhiên với các tài nguyên đám mây thông qua trợ lý AI. Hướng dẫn này sẽ cung cấp những điều cần thiết để thực hiện tích hợp OCI-MCP.

Tích Hợp OCI-MCP là gì?

Tích hợp OCI-MCP cho phép bạn quản lý các tài nguyên Oracle Cloud bằng các giao diện đối thoại. Bằng cách bao bọc các lệnh SDK OCI trong một máy chủ MCP, bạn có thể thực hiện các thao tác trên đám mây thông qua các lệnh bằng ngôn ngữ tự nhiên.

Kiến trúc

AI Assistant ↔ MCP Server ↔ OCI SDK ↔ Oracle Cloud

Cài đặt Nhanh

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

• Tài khoản Oracle Cloud Infrastructure
• Python 3.8+ cho máy chủ MCP
• OCI CLI và SDK đã được cài đặt
• Claude Desktop hoặc khách hàng MCP

Bước 1: Tạo Máy chủ MCP

from mcp import Server
from oci import config, compute

class OCIMCPServer:
    def __init__(self):
        self.config = config.from_file()
        self.compute_client = compute.ComputeClient(self.config)

    def list_instances(self, compartment_id):
        return self.compute_client.list_instances(compartment_id)

Bước 2: Cấu hình Xác thực

# Cấu hình ~/.oci/config
[DEFAULT]
user=ocid1.user.oc1..your_user_ocid
fingerprint=your_key_fingerprint
key_file=~/.oci/oci_api_key.pem
tenancy=ocid1.tenancy.oc1..your_tenancy_ocid
region=us-ashburn-1

Bước 3: Định nghĩa Công cụ

@server.tool("list_compute_instances")
def list_compute_instances(compartment_id: str):
    try:
        response = compute_client.list_instances(compartment_id=compartment_id)
        return [{"name": instance.display_name, 
                "state": instance.lifecycle_state} 
               for instance in response.data]
    except Exception as e:
        return {"error": str(e)}

Bước 4: Đăng ký với Claude

{
  "mcpServers": {
    "oci-integration": {
      "command": "python",
      "args": ["oci-mcp-server.py"]
    }
  }
}

Các Trường Hợp Sử Dụng Chính

Quản lý Tính toán

• Liệt kê, khởi động, dừng các phiên bản
• Thay đổi kích thước hình dạng tính toán
• Lấy chỉ số hiệu suất

Ví dụ: "Cho tôi xem tất cả các phiên bản đã dừng"

Các Hoạt Động Cơ Sở Dữ Liệu

• Khởi động/dừng Cơ sở dữ liệu Tự động
• Thay đổi quy mô tài nguyên
• Quản lý sao lưu

Ví dụ: "Thay đổi quy mô cơ sở dữ liệu sản xuất thành 4 OCPUs"

Quản lý Lưu trữ

• Liệt kê các bucket và đối tượng
• Tải lên/tải xuống tệp
• Tạo URL truy cập

Các Dịch vụ Bổ sung

• Mạng (VCNs, bộ cân bằng tải)
• Giám sát (chỉ số, cảnh báo)
• IAM (người dùng, chính sách)
• Quản lý chi phí

Lợi ích

1. Kiểm soát bằng Ngôn ngữ Tự nhiên: Sử dụng tiếng Anh đơn giản thay vì các lệnh CLI phức tạp
2. Hiệu quả Vận hành: Thực hiện nhanh hơn và giảm độ khó học
3. Tích hợp Đa nền tảng: Kết hợp với các hệ thống khác
4. Bảo mật Nâng cao: Tận dụng xác thực gốc của OCI

Các Thực hành Bảo mật Tốt nhất

• Sử dụng nguyên tắc quyền tối thiểu
• Thực hiện quay vòng khóa định kỳ
• Tách biệt thông tin xác thực theo môi trường
• Bật ghi lại kiểm toán

# Cấu hình bảo mật
class SecureOCIConfig:
    def __init__(self):
        if os.getenv('OCI_RESOURCE_PRINCIPAL_VERSION'):
            self.signer = InstancePrincipalsSecurityTokenSigner()
        else:
            self.config = config.from_file()

Giải quyết Vấn đề

Vấn đề Xác thực

• Kiểm tra cấu hình khóa API
• Kiểm tra quyền truy cập tệp khóa
• Xác thực quyền IAM

Lỗi Quyền

• Xem xét các chính sách IAM
• Kiểm tra quyền truy cập vào compartment
• Xác minh khả năng nhìn thấy tài nguyên

Ví dụ Thực tế

@server.tool("auto_scale_web_tier")
def auto_scale_web_tier(compartment_id: str):
    instances = list_compute_instances(compartment_id)
    # Kiểm tra chỉ số và thay đổi quy mô nếu cần
    if high_cpu_detected(instances):
        return scale_instances(compartment_id, 'up')
    return {"status": "Không cần thay đổi quy mô"}

Sử dụng: "Kiểm tra xem tầng web có cần thay đổi quy mô không"

Bắt đầu

1. Thiết lập môi trường OCI
2. Cài đặt các phụ thuộc
3. Tạo công cụ MCP đầu tiên
4. Kiểm tra với các lệnh đơn giản
5. Mở rộng chức năng
6. Thêm giám sát

Kết luận

Tích hợp OCI-MCP biến đổi các hoạt động đám mây bằng cách cho phép tương tác bằng ngôn ngữ tự nhiên với Oracle Cloud Infrastructure. Điều này giảm bớt độ phức tạp và làm cho việc quản lý đám mây trở nên dễ tiếp cận hơn.

Bắt đầu với các thao tác cơ bản và dần dần mở rộng đến các quy trình làm việc phức tạp khi đội ngũ của bạn làm quen với công nghệ.

Tài nguyên

• Tài liệu SDK OCI
• Giao thức Ngữ cảnh Mô hình
• Tham khảo OCI CLI