Tencent Cloud COS MCP

Tiếng Việt | English

Tencent Cloud COS MCP Server 🚀🚀🚀

Tencent Cloud COS MCP Server dựa trên giao thức MCP, cho phép mô hình lớn nhanh chóng tích hợp khả năng lưu trữ đám mây Tencent (COS) và Xử lý dữ liệu thông minh (CI) mà không cần viết mã.

---

✨ Tính năng cốt lõi

Khả năng lưu trữ đám mây

• ⬆️ Tải tệp lên đám mây
• ⬇️ Tải tệp từ đám mây xuống
• 📋 Lấy danh sách tệp trên đám mây

Khả năng xử lý trên đám mây

• 🖼️ Lấy thông tin hình ảnh
• 🔍 Siêu phân giải hình ảnh
• ✂️ Cắt ảnh
• 📲 Nhận dạng mã QR
• 🏆 Đánh giá chất lượng hình ảnh
• 🅰️ Watermark văn bản
• 🎬 Truy xuất metadata/ngôn ngữ tự nhiên (MateInsight)
• 📄 Chuyển đổi tài liệu sang PDF
• 🎥 Ảnh bìa video

---

💡 Tình huống ứng dụng điển hình

• Dữ liệu văn bản/hình ảnh/video/âm thanh thu được từ các khả năng MCP khác có thể được tải trực tiếp lên lưu trữ đám mây COS.
• Dữ liệu cục bộ nhanh chóng được chuyển đến lưu trữ/sao lưu đám mây COS thông qua mô hình lớn.
• Tự động hóa thông qua mô hình lớn: chuyển hàng loạt dữ liệu video/hình ảnh/âm thanh/văn bản từ trang web vào lưu trữ đám mây COS.
• Tự động xử lý dữ liệu video/hình ảnh/âm thanh/văn bản trên đám mây và chuyển vào lưu trữ đám mây COS.

---

🌟 Ví dụ tính năng

1. Tải tệp lên COS
   
2. Đánh giá chất lượng hình ảnh
   
3. Truy xuất hình ảnh bằng ngôn ngữ tự nhiên
   
4. Chụp khung hình từ video
   

---

🔧 Cài đặt và Sử dụng

Giải thích tham số

Để bảo vệ quyền riêng tư dữ liệu của bạn, vui lòng chuẩn bị các tham số sau:

1. SecretId / SecretKey

• Giải thích: Khóa bí mật của Tencent Cloud COS, dùng để xác thực danh tính, vui lòng giữ an toàn và không tiết lộ.
• Cách lấy:
  1. Truy cập Quản lý khóa Tencent Cloud.
  2. Tạo khóa mới và sao chép SecretId và SecretKey được tạo.

2. Bucket

• Ví dụ: mybucket-123456
• Giải thích: Tên bucket, dùng để lưu trữ dữ liệu, tương đương với không gian lưu trữ cá nhân của bạn.
• Cách lấy:
  1. Truy cập Danh sách bucket.
  2. Sao chép tên bucket. Nếu chưa có bucket, có thể nhấp "Tạo bucket", thường chọn cấu hình mặc định để nhanh chóng hoàn tất tạo.

3. Region

• Ví dụ: ap-beijing
• Giải thích: Khu vực địa lý nơi bucket được đặt.
• Cách lấy:
  1. Tìm bucket trong Danh sách bucket.
  2. Xem khu vực tương ứng ở dòng tên bucket và sao chép, ví dụ: ap-beijing.

4. DatasetName

• Giải thích: Tham số không bắt buộc, cần cho thao tác truy xuất thông minh dữ liệu.
• Cách lấy:
  1. Truy cập Quản lý tập dữ liệu.
  2. Tạo tập dữ liệu và đợi chỉ mục được xây dựng xong, sau đó sao chép tên tập dữ liệu.

5. connectType

• Giải thích: Tham số không bắt buộc, chỉ định phương thức kết nối, giá trị tùy chọn là stdio (cục bộ) hoặc sse (từ xa).
• Giá trị mặc định: stdio

6. port

• Giải thích: Tham số không bắt buộc, khi phương thức kết nối là sse, có thể tự do thiết lập cổng.
• Giá trị mặc định: 3001

---

Khởi động từ npx

Khi sử dụng trong mô hình lớn (ví dụ: cursor), cần cấu hình trong mcp.json:

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--Region=yourRegion",
        "--Bucket=yourBucket",
        "--SecretId=yourSecretId",
        "--SecretKey=yourSecretKey",
        "--DatasetName=yourDatasetname"
      ]
    }
  }
}

Cũng có thể cấu hình qua JSON:

{
  "mcpServers": {
    "cos-mcp": {
      "command": "npx",
      "args": [
        "cos-mcp",
        "--cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"yourBucket\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"yourDatasetname\"}'"
      ]
    }
  }
}

---

Cài đặt bằng npm

# 安装
npm install -g cos-mcp@latest

# 运行开启 SSE 模式
cos-mcp --Region=yourRegion --Bucket=yourBucket --SecretId=yourSecretId --SecretKey=yourSecretKey --DatasetName=yourDatasetname --port=3001 --connectType=sse

# 或通过 JSON 配置
cos-mcp --cos-config='{"Region":"yourRegion","Bucket":"BucketName-APPID","SecretId":"yourSecretId","SecretKey":"yourSecretKey","DatasetName":"datasetName"}' --port=3001 --connectType=sse

Khi sử dụng chế độ SSE trong mô hình lớn (ví dụ: cursor), cần cấu hình trong mcp.json:

{
  "mcpServers": {
    "cos-mcp": {
      "url": "http://localhost:3001/sse"
    }
  }
}

---

Cài đặt từ mã nguồn

Bước 1: Sao chép mã dự án

git clone https://github.com/Tencent/cos-mcp.git
cd cos-mcp

Bước 2: Cài đặt phụ thuộc

npm install

Bước 3: Khởi động dịch vụ

3.1 Cấu hình biến môi trường cục bộ

Tạo tệp .env và cấu hình các biến môi trường sau:

Region='yourRegion'
Bucket='yourBucket'
SecretId='yourSecretId'
SecretKey='yourSecretKey'
DatasetName="yourDatasetName"

3.2 Khởi động chế độ SSE cục bộ (Cách 1)

npm run start:sse

3.3 Sau khi build cục bộ, sử dụng chế độ STDIO (Cách 2)

npm run build

Sản phẩm build nằm ở dist/index.js.

---

Bước 4: Sử dụng trong mô hình lớn

Cấu hình chế độ SSE

{
  "mcpServers": {
    "cos-mcp": {
      "url": "http://localhost:3001/sse"
    }
  }
}

Cấu hình chế độ STDIO

{
  "mcpServers": {
    "cos-mcp": {
      "command": "node",
      "args": [
        "${your work space}/dist/index.js"
      ]
    }
  }
}

Sau khi hoàn tất các bước trên, bạn có thể chạy COS MCP Server từ mã nguồn.

---

⚠️ Lưu ý

1. Nếu đã cài đặt phiên bản gói cũ, bạn có thể thay đổi cos-mcp thành cos-mcp@latest trong nội dung trên để cài đặt phiên bản mới nhất.
2. Nếu sau khi cài đặt toàn cục, sử dụng trực tiếp cos-mcp không được, có thể do vấn đề biến toàn cục, bạn có thể sử dụng biến tách rời hoặc cách khởi động npx:

   npm install -g cos-mcp@latest
   cos-mcp --cos-config=xxx --port=3001 --connectType=sse
   

   Lệnh trên có hiệu lực tương đương:

   npx cos-mcp@latest --cos-config=xxx --port=3001 --connectType=sse
   

3. Nếu gặp vấn đề phân tích cú pháp, có thể do terminal nhạy cảm với dấu ngoặc kép, bạn có thể thay đổi tham số cấu hình sang định dạng sau và thử lại:

   --cos-config='{\"Region\":\"yourRegion\",\"Bucket\":\"BucketName-APPID\",\"SecretId\":\"yourSecretId\",\"SecretKey\":\"yourSecretKey\",\"DatasetName\":\"datasetName\"}' --port=3001 --connectType=sse