TOS MCP 서버

“TOS” MCP 서버는 무엇을 하나요?

TOS MCP 서버는 ByteDance Volcengine의 TOS(텐센트 오브젝트 스토리지) 플랫폼에 대한 강력한 질의 기능을 제공하기 위해 설계된 공식 솔루션입니다. 사용자는 자연어를 이용해 저장된 콘텐츠를 탐색하고 조회할 수 있어 데이터 접근이 더욱 직관적이고 효율적입니다. Model Context Protocol(MCP)을 활용해 AI 어시스턴트와 개발자 도구가 데이터베이스 질의, 파일 관리, 스토리지 서비스와의 프로그래밍적 상호작용을 원활하게 수행할 수 있습니다. 이를 통해 리소스 탐색이 간편해지고, 다른 Volcengine 클라우드 제품과의 연동을 지원해 더 지능적인 비즈니스 애플리케이션과 자동화가 가능합니다.

프롬프트 목록

• 列举火山引擎 TOS 的存储桶列表。
  계정 내 모든 TOS 버킷을 나열하는 프롬프트 템플릿입니다.
• 列举火山引擎 TOS 的 example 桶下的对象。
  특정 TOS 버킷 내 오브젝트를 나열하는 프롬프트 템플릿입니다.

리소스 목록

• 存储桶 (버킷)
  TOS 내에서 오브젝트를 관리하고 조직하기 위한 저장 컨테이너 리소스입니다.
• 对象 (오브젝트)
  버킷 내에 저장된 개별 파일 또는 데이터 항목을 나타내며, 서버를 통해 접근 및 관리할 수 있습니다.
• 存储桶属性 (버킷 속성)
  버킷 이름, 생성 시각, 위치, 접근 도메인 등 메타데이터를 포함합니다.
• 对象属性 (오브젝트 속성)
  오브젝트 이름, 수정 시각, ETag, 크기, 저장 유형 등을 포함합니다.

도구 목록

• list_buckets
  사용자의 Volcengine TOS 계정 내 모든 스토리지 버킷의 목록을 이름, 생성 시각, 접근 도메인 등과 함께 반환합니다.
• list_objects
  지정된 TOS 버킷 내 오브젝트를 나열하며, 접두사 필터링, 페이지네이션, 지속 토큰 등 옵션을 지원합니다.
• get_object
  TOS 버킷에 저장된 특정 오브젝트의 상세 정보나 콘텐츠를 조회합니다.

MCP 서버의 사용 예시

• 스토리지 리소스 탐색
  개발자와 AI 어시스턴트가 사용 가능한 버킷 및 오브젝트를 빠르게 나열하여 데이터 인벤토리를 파악하고 감사할 수 있습니다.
• AI 워크플로우를 위한 데이터 조회
  LLM 및 자동화 스크립트가 분석, 학습, 추가 처리용 파일이나 메타데이터를 조회할 수 있습니다.
• 효율적인 콘텐츠 관리
  대규모 파일 컬렉션을 표준화된 도구로 나열, 필터링, 상세 조회하는 작업을 지원합니다.
• 지능형 비즈니스 애플리케이션과 연동
  다른 Volcengine MCP 제품과 결합하여 자동 인덱싱, 검색, 콘텐츠 추천 등 데이터 중심 워크플로우를 구축할 수 있습니다.
• 자동화된 보고 및 감사
  정기적으로 스토리지 내용을 나열 및 점검하여 컴플라이언스 및 모니터링 요구사항을 지원합니다.

설치 방법

Windsurf

1. 시스템에 Node.js가 설치되어 있는지 확인하세요.
2. Windsurf 설정 파일을 엽니다.
3. 아래 JSON을 사용해 mcpServers 섹션에 TOS MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "tos-mcp": {
         "command": "npx",
         "args": ["@tos/mcp-server@latest"]
       }
     }
   }
   

4. 설정을 저장하고 Windsurf를 재시작하세요.
5. Windsurf에서 MCP 질의로 정상 설치를 확인하세요.

Claude

1. Node.js가 설치되어 있는지 확인하세요.
2. Claude 도구의 설정 디렉토리로 이동합니다.
3. mcpServers 아래에 TOS MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "tos-mcp": {
         "command": "npx",
         "args": ["@tos/mcp-server@latest"]
       }
     }
   }
   

4. 변경사항을 저장 후 Claude를 재시작하세요.
5. 샘플 프롬프트로 연결을 확인하세요.

Cursor

1. Node.js가 사용 가능한지 확인하세요.
2. Cursor의 설정 파일을 찾으세요.
3. mcpServers 배열에 TOS MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "tos-mcp": {
         "command": "npx",
         "args": ["@tos/mcp-server@latest"]
       }
     }
   }
   

4. 저장 후 Cursor를 재시작하세요.
5. 버킷 목록 프롬프트로 설치를 테스트하세요.

Cline

1. Node.js가 없다면 설치하세요.
2. Cline용 MCP 서버 설정 파일을 엽니다.
3. TOS MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "tos-mcp": {
         "command": "npx",
         "args": ["@tos/mcp-server@latest"]
       }
     }
   }
   

4. 저장 후 Cline을 재시작하세요.
5. TOS 리소스 나열로 확인하세요.

API 키 보안:
민감한 자격 증명은 환경 변수로 보관하세요. 예시:

{
  "mcpServers": {
    "tos-mcp": {
      "command": "npx",
      "args": ["@tos/mcp-server@latest"],
      "env": {
        "TOS_ACCESS_KEY": "YOUR_ACCESS_KEY",
        "TOS_SECRET_KEY": "YOUR_SECRET_KEY"
      },
      "inputs": {
        "region": "ap-guangzhou"
      }
    }
  }
}

플로우 내에서 MCP 사용하는 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 먼저 플로우에 MCP 컴포넌트를 추가하고 AI 에이전트에 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "tos-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면, AI 에이전트가 이 MCP를 도구로 사용하여 모든 기능과 역량에 접근할 수 있습니다. “tos-mcp” 부분은 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 주소로 바꿔야 함을 잊지 마세요.

개요

의견

이 MCP 서버는 TOS 스토리지 리소스와 상호작용할 수 있는 명확한 문서와 실용적 도구를 제공합니다. 단순 리소스 나열부터 지능형 워크플로우 통합까지 다양한 사용 사례를 지원하지만, Roots 또는 Sampling과 같은 고급 MCP 기능 지원에 대한 언급은 없습니다.

위 표를 참고했을 때, 이 MCP 서버의 평가는 7/10입니다: 기본 기능과 안내는 훌륭하지만 Roots, Sampling 등 고급 기능에 대한 명확성이 부족하고 LICENSE 파일이 없습니다.

MCP 점수