Català | English

Tencent Cloud COS MCP Server 🚀🚀🚀

Basat en el protocol MCP, el Tencent Cloud COS MCP Server permet a models grans connectar-se ràpidament a l’emmagatzematge COS i a les capacitats de Data Insight (CI) sense necessitat de programació.

✨ Funcionalitats principals

Capacitat d’emmagatzematge al núvol

⬆️ Carrega fitxers al núvol
⬇️ Descarrega fitxers del núvol
📋 Obtén la llista de fitxers al núvol

Capacitat de processament al núvol

🖼️ Obtén informació de la imatge
🔍 Superresolució d’imatges
✂️ Retalla imatges
📲 Reconeixement de codis QR
🏆 Avaluació de la qualitat de la imatge
🅰️ Marca d’aigua de text
🎬 Recuperació de metadades / cerca en llenguatge natural (MateInsight)
📄 Converteix documents a PDF
🎥 Captura de miniatura de vídeo

💡 Escenaris d’ús típics

Els textos, imatges, vídeos i àudios obtinguts amb altres capacitats MCP es poden carregar directament a l’emmagatzematge COS al núvol.
Transferència ràpida de dades locals a l’emmagatzematge COS al núvol / còpia de seguretat amb el model gran.
Automatització amb el model gran: transferència massiva de dades de vídeo/imatge/àudio/text de pàgines web al núvol COS.
Processament automàtic de vídeo/imatge/àudio/text al núvol i transferència a l’emmagatzematge COS.

🌟 Exemples de funcionalitat

Carrega de fitxers a COS
Avaluació de la qualitat de la imatge
Cerca en llenguatge natural d’imatges
Captura de fotograma de vídeo

🔧 Instal·lació i ús

Explicació dels paràmetres

Per protegir la confidencialitat de les teves dades, prepara els següents paràmetres:

1. SecretId / SecretKey

Explicació: Clau d’identificació de Tencent Cloud COS. Guarda-la amb cura i no la comparteixis.
Com obtenir-la:
1. Visita Tencent Cloud Key Management.
2. Crea una nova clau i copia el SecretId i el SecretKey generats.

2. Bucket

Exemple: mybucket-123456
Explicació: Nom del bucket, l’espai d’emmagatzematge personal.
Com obtenir-lo:
1. Visita Bucket List.
2. Copia el nom del bucket. Si no en tens, fes clic a “Create Bucket” i segueix la configuració per defecte.

3. Region

Exemple: ap-beijing
Explicació: Regió on es troba el bucket.
Com obtenir-lo:
1. En la Bucket List, localitza el bucket.
2. Al mateix renglon, copia la regió, per exemple: ap-beijing.

4. DatasetName

Explicació: Paràmetre opcional, necessari per a operacions de recerca intel·ligent de dades.
Com obtenir-lo:
1. Visita Dataset Management.
2. Crea un dataset i espera que l’índex es construïi completament, després copia el nom del dataset.

5. connectType

Explicació: Paràmetre opcional, tipus de connexió. Valors possibles: stdio (local) o sse (remot).
Valor per defecte: stdio

6. port

Explicació: Paràmetre opcional. Si el tipus de connexió és sse, pots establir el port lliurement.
Valor per defecte: 3001

Inici amb npx

Quan s’utilitza dins d’un model gran (ex.: cursor), configura mcp.json així:

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

O amb configuració JSON:

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

Instal·lació amb npm

# Instal·lació
npm install -g cos-mcp@latest

# Execució en mode SSE
cos-mcp --Region=yourRegion --Bucket=yourBucket --SecretId=yourSecretId --SecretKey=yourSecretKey --DatasetName=yourDatasetname --port=3001 --connectType=sse

# O amb configuració JSON
cos-mcp --cos-config='{"Region":"yourRegion","Bucket":"BucketName-APPID","SecretId":"yourSecretId","SecretKey":"yourSecretKey","DatasetName":"datasetName"}' --port=3001 --connectType=sse

En el model gran amb mode SSE (ex.: cursor), configura mcp.json així:

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

Instal·lació a partir del codi font

Pas 1: Clona el projecte

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

Pas 2: Instal·la les dependències

npm install

Pas 3: Inicia el servei

3.1 Configura variables d’entorn locals

Crea un fitxer .env i configura les variables següents:

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

3.2 Inici en mode SSE (en local, mètode 1)

npm run start:sse

3.3 Construcció i ús en mode STDIO (en local, mètode 2)

npm run build

El resultat es troba a dist/index.js.

Pas 4: Ús dins del model gran

Configuració en mode SSE

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

Configuració en mode STDIO

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

Un cop completats aquests passos, pots executar el Tencent Cloud COS MCP Server a partir del codi font.

⚠️ Notes importants

Si tens una versió antiga del paquet, canvia cos-mcp per cos-mcp@latest per instal·lar la versió més recent.
Si després d’instal·lar globalment cos-mcp no funciona, pot ser un problema amb la variable global. Prova amb variables separades o amb npx:
```
npm install -g cos-mcp@latest
cos-mcp --cos-config=xxx --port=3001 --connectType=sse
```
Aquesta ordre és equivalent a:
```
npx cos-mcp@latest --cos-config=xxx --port=3001 --connectType=sse
```

Si apareixen problemes de parseig, pot ser que el terminal sigui sensible a les cometes dobles. Prova amb aquesta sintaxi:

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