TOS MCP Server

Explore e recupere conteúdo do Tinder Object Storage (TOS) da Volcengine usando consultas em linguagem natural.

Documentação

TOS MCP Server

O MCP Server oficial da TOS oferece poderosas capacidades de consulta, permitindo explorar e recuperar conteúdo armazenado na TOS de forma conveniente por meio de linguagem natural, aumentando a intuitividade e a eficiência do acesso a dados. Pode ser combinado com o MCP de produtos de nuvem da Volcano Engine para ajudar a construir cenários de aplicação de negócios mais inteligentes.

Versão	v0.2.0
Descrição	Gerenciar recursos TOS com base em MCP, explorando dados de forma inteligente
Categoria	Armazenamento
Tags	Busca, Vídeo, Imagem, Texto

Tools

Este produto MCP Server oferece as seguintes Tools (ferramentas/capacidades):

Tool 1: list_buckets

Tipo

SaaS

Descrição detalhada

Esta ferramenta permite visualizar convenientemente a lista de buckets de armazenamento da TOS da Volcano Engine.

Parâmetros de entrada necessários para depuração:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [],
    "properties": {}
  },
  "name": "list_buckets",
  "description": "查询您账号下拥有的所有存储桶的列表。"
}

Saída:

Retorna a lista de buckets sob sua conta, incluindo nome do bucket, horário de criação, informações de localização do bucket, domínio de acesso e outras informações.

Exemplo de Prompt mais facilmente acionado

列举火山引擎 TOS 的存储桶列表。

Tool 2: list_objects

Tipo

SaaS

Descrição detalhada

Esta ferramenta permite visualizar convenientemente a lista de objetos sob um bucket da TOS da Volcano Engine. Cada solicitação retorna parte ou todos os objetos do bucket (no máximo 1000). Você pode usar os parâmetros da solicitação como condições de seleção para retornar um subconjunto de objetos no bucket.

Parâmetros de entrada necessários para depuração:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "prefix": {
        "type": "string",
        "description": "可选的对象前缀"
      },
      "start_after": {
        "type": "string",
        "description": "列举对象的起始位置。您可以通过指定对象的起始位置分页列举对象"
      },
      "continuation_token": {
        "type": "string",
        "description": "指定列举操作从该 Token 开始，通常从上次请求返回的 NextContinuationToken 中获取此 Token"
      }
    }
  },
  "name": "list_objects",
  "description": "查询您指定存储桶的对象列表"
}

Saída:

Retorna a lista de objetos no armazenamento especificado, incluindo nome do objeto, horário da última modificação, ETag, tamanho do objeto, tipo de armazenamento e outras informações.

Exemplo de Prompt mais facilmente acionado

列举火山引擎 TOS 的 example 桶下的对象。

Tool 3: get_object tool

Tipo

SaaS

Descrição detalhada

Recupera um objeto da TOS, sendo necessário especificar o nome do bucket e o caminho completo do objeto. Para objetos com conteúdo de texto, como arquivos de texto, arquivos CSV, etc., esta ferramenta retorna o conteúdo. Para objetos binários, como imagens, vídeos, etc., esta ferramenta retorna o conteúdo codificado em Base64.

Parâmetros de entrada necessários para depuração:

Entrada:

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket",
      "key"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "key": {
        "type": "string",
        "description": "用户需要读取的对象名，需要指定完整的对象名"
      }
    }
  },
  "name": "get_object",
  "description": "获取指定对象的内容，对于文本内容的对象，比如文本文件、CSV 文件等，该工具返回的是其内容。对于图片、视频等二进制对象，该工具返回的是Base64编码的内容。"
}

Saída:

Retorna o conteúdo específico do objeto. Para objetos com conteúdo de texto, como arquivos de texto, arquivos CSV, etc., esta ferramenta retorna o conteúdo. Para objetos binários, como imagens, vídeos, etc., esta ferramenta retorna o conteúdo codificado em Base64.

Exemplo de Prompt mais facilmente acionado

读取火山引擎 TOS 桶example下对象名为example.txt的文件内容

Plataformas compatíveis

Ark, python, cursor

Link de ativação do serviço (produto completo)

https://console.volcengine.com/tos

Método de autenticação

Volcano Engine. Obtenha o ID da chave de acesso, a chave de acesso secreta e a região da Volcano Engine no console de gerenciamento da volcengine. Configure as variáveis de ambiente relacionadas no arquivo .env

Variáveis de ambiente

As seguintes variáveis de ambiente podem ser usadas para configurar o servidor MCP:

Variável de ambiente	Descrição	Valor padrão
`VOLCENGINE_ACCESS_KEY`	Chave de acesso da conta Volcano Engine	-
`VOLCENGINE_SECRET_KEY`	Chave secreta da conta Volcano Engine	-
`VOLCENGINE_REGION`	Região TOS da Volcano Engine	-
`TOS_ENDPOINT`	Endpoint TOS da Volcano Engine	-
`SECURITY_TOKEN`	Token de segurança da Volcano Engine, opcional	-
`TOS_BUCKETS`	Bucket TOS a ser acessado, opcional	-

Instalação e implantação

Dependências do sistema

Instalar Python 3.10 ou versão superior

Instalar uv

Se for sistema Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Se for sistema Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Sincronizar dependências e atualizar uv.lock:
```
uv sync
```
Construir o servidor MCP:
```
uv build
```

Usando uv (recomendado)

Ao usar uv, nenhuma instalação específica é necessária. Usaremos uvx para executar diretamente o mcp-server-tos.

Configuração local

Adicione a seguinte configuração ao seu arquivo de configurações do mcp

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_tos",
        "run",
        "mcp-server-tos"
      ]
    }
  }
}

Configuração em diferentes plataformas

Ark

Centro de experiência

[Exemplo abaixo]

Visualizar detalhes do MCP Server Na praça do ecossistema de grandes modelos, selecione o MCP Server apropriado e visualize os detalhes
Selecionar a plataforma onde o MCP Server será executado Verifique as plataformas compatíveis com o MCP Server atual e selecione a plataforma apropriada
Visualizar e comparar as Tools disponíveis Examine cuidadosamente as descrições de funcionalidade e os parâmetros de entrada necessários das Tools disponíveis e tente executar as funções correspondentes.
Obter URL exclusivo ou exemplo de código Verifique o status de login da conta e a ativação do serviço para gerar um URL exclusivo
Ir para a plataforma do Client correspondente para uso Clique no botão de atalho para ir ao centro de experiência da plataforma Ark para experimentar o MCP Server correspondente

Capturas de tela/vídeo do produto - opcional

Cursor

Implantação

[Exemplo abaixo]

UVX

{
  "mcpServers": {
    "tos-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_tos",
        "mcp-server-tos"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "tos region",
        "TOS_ENDPOINT": "tos endpoint",
        "SECURITY_TOKEN": "your security token",
        "TOS_BUCKET": "your specific bucket"
      }
    }
  }
}

Licença

volcengine/mcp-server é licenciado sob a Licença MIT.