Tencent Cloud COS MCP

한국어 | English

Tencent Cloud COS MCP Server 🚀🚀🚀

MCP 프로토콜 기반의 Tencent Cloud COS MCP Server로, 코딩 없이 대규모 모델이 Tencent Cloud Storage(COS) 및 Data Vault(CI) 기능에 빠르게 접근할 수 있도록 합니다.

---

✨ 핵심 기능

클라우드 스토리지 기능

• ⬆️ 클라우드로 파일 업로드
• ⬇️ 클라우드에서 파일 다운로드
• 📋 클라우드 파일 목록 조회

클라우드 처리 기능

• 🖼️ 이미지 정보 조회
• 🔍 이미지 초해상도
• ✂️ 이미지 자르기
• 📲 QR 코드 인식
• 🏆 이미지 품질 평가
• 🅰️ 텍스트 워터마크
• 🎬 메타데이터/자연어 검색 (MateInsight)
• 📄 문서를 PDF로 변환
• 🎥 비디오 썸네일

---

💡 주요 활용 시나리오

• 다른 MCP 기능으로 획득한 텍스트/이미지/비디오/오디오 등의 데이터를 COS 클라우드 스토리지에 직접 업로드할 수 있습니다.
• 로컬 데이터를 대규모 모델을 통해 COS 클라우드 스토리지로 빠르게 이전/백업할 수 있습니다.
• 대규모 모델을 통해 자동화: 웹페이지의 비디오/이미지/오디오/텍스트 등의 데이터를 COS 클라우드 스토리지로 일괄 이전할 수 있습니다.
• 비디오/이미지/오디오/텍스트 등의 데이터를 클라우드에서 자동으로 처리하고 COS 클라우드 스토리지로 이전할 수 있습니다.

---

🌟 기능 예시

1. COS에 파일 업로드
   
2. 이미지 품질 평가
   
3. 자연어로 이미지 검색
   
4. 비디오 프레임 캡처
   

---

🔧 설치 및 사용

매개변수 설명

데이터 프라이버시 보호를 위해 다음 매개변수를 준비하십시오:

1. SecretId / SecretKey

• 설명: Tencent Cloud COS의 키로, 인증에 사용되며 안전하게 보관하고 유출하지 마십시오.
• 획득 방법:
  1. Tencent Cloud 키 관리에 접속합니다.
  2. 새 키를 생성하고 생성된 SecretId와 SecretKey를 복사합니다.

2. Bucket

• 예시: mybucket-123456
• 설명: 데이터를 저장하는 버킷 이름으로, 개인 저장 공간에 해당합니다.
• 획득 방법:
  1. 버킷 목록에 접속합니다.
  2. 버킷 이름을 복사합니다. 버킷이 없으면 "버킷 생성"을 클릭하고 일반적으로 기본 설정으로 빠르게 생성할 수 있습니다.

3. Region

• 예시: ap-beijing
• 설명: 버킷이 위치한 리전입니다.
• 획득 방법:
  1. 버킷 목록에서 버킷을 찾습니다.
  2. 버킷 이름 행에서 해당 리전을 확인하고 복사합니다(예: ap-beijing).

4. DatasetName

• 설명: 선택적 매개변수로, 데이터 지능형 검색 작업에 필요합니다.
• 획득 방법:
  1. 데이터셋 관리에 접속합니다.
  2. 데이터셋을 생성하고 인덱스 구축이 완료되면 데이터셋 이름을 복사합니다.

5. connectType

• 설명: 선택적 매개변수로, 연결 방식을 지정하며 선택 가능한 값은 stdio(로컬) 또는 sse(원격)입니다.
• 기본값: stdio

6. port

• 설명: 선택적 매개변수로, 연결 방식이 sse일 때 포트를 자유롭게 설정할 수 있습니다.
• 기본값: 3001

---

npx로 시작하기

대규모 모델 내에서 사용할 때(예: cursor), mcp.json에 설정해야 합니다:

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

JSON을 통해 설정할 수도 있습니다:

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

---

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

대규모 모델 내에서 SSE 모드를 사용할 때(예: cursor), mcp.json에 설정해야 합니다:

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

---

소스 코드로 설치하기

1단계: 프로젝트 코드 클론

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

2단계: 의존성 설치

npm install

3단계: 서비스 시작

3.1 로컬 환경 변수 설정

.env 파일을 생성하고 다음 환경 변수를 설정합니다:

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

3.2 로컬 SSE 모드로 시작 (방법 1)

npm run start:sse

3.3 로컬 빌드 후 STDIO 모드 사용 (방법 2)

npm run build

빌드 결과물은 dist/index.js에 위치합니다.

---

4단계: 대규모 모델 내에서 사용

SSE 모드 설정

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

STDIO 모드 설정

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

위 단계를 완료하면 소스 코드를 통해 COS MCP Server를 실행할 수 있습니다.

---

⚠️ 주의사항

1. 이전 버전의 패키지가 설치된 경우, 위 내용의 cos-mcp을 cos-mcp@latest로 변경하여 최신 버전 패키지를 설치할 수 있습니다.
2. 전역 설치 후 cos-mcp를 직접 사용할 수 없는 경우, 전역 변수 문제일 수 있으므로 변수를 분리하거나 npx 방식으로 시작할 수 있습니다:

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

   위 명령은 다음과 동일한 효과를 냅니다:

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

3. 구문 분석 문제가 발생하면 터미널이 큰따옴표에 민감한 것일 수 있으므로, 설정 매개변수를 다음 형식으로 변경하여 다시 시도하십시오:

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