TOS MCP Server

O que faz o servidor “TOS” MCP?

O TOS MCP Server é uma solução oficial projetada para fornecer capacidades avançadas de consulta para a plataforma TOS (Tencent Object Storage) da Volcengine (ByteDance). Ele permite que usuários explorem e recuperem conteúdos armazenados utilizando linguagem natural, tornando o acesso aos dados mais intuitivo e eficiente. Ao utilizar o Model Context Protocol (MCP), esse servidor possibilita que assistentes de IA e ferramentas de desenvolvedor realizem consultas ao banco de dados de forma integrada, gerenciem arquivos e interajam com serviços de armazenamento programaticamente. Isso aprimora os fluxos de trabalho dos desenvolvedores ao simplificar a descoberta de recursos e permitir integração com outros produtos em nuvem da Volcengine, viabilizando aplicações de negócios mais inteligentes e automação.

Lista de Prompts

• 列举火山引擎 TOS 的存储桶列表。
  Prompt template para listar todos os buckets TOS de uma conta.
• 列举火山引擎 TOS 的 example 桶下的对象。
  Prompt template para listar objetos dentro de um bucket TOS específico.

Lista de Recursos

• 存储桶 (Buckets)
  Um recurso que representa contêineres de armazenamento dentro do TOS, utilizado para organizar e gerenciar objetos.
• 对象 (Objects)
  Representa arquivos individuais ou entradas de dados armazenados dentro de um bucket, acessíveis e gerenciáveis via o servidor.
• 存储桶属性 (Bucket Properties)
  Inclui metadados como nome do bucket, data de criação, localização e domínios de acesso.
• 对象属性 (Object Properties)
  Inclui nome do objeto, data de modificação, ETag, tamanho e tipo de armazenamento.

Lista de Ferramentas

• list_buckets
  Recupera a lista de todos os buckets de armazenamento na conta TOS da Volcengine do usuário, incluindo detalhes como nomes dos buckets, datas de criação e domínios de acesso.
• list_objects
  Lista objetos dentro de um bucket TOS especificado, com opções de filtragem por prefixo, paginação e tokens de continuação.
• get_object
  Busca informações detalhadas ou o conteúdo de um objeto específico armazenado em um bucket TOS.

Casos de Uso deste MCP Server

• Exploração de Recursos de Armazenamento
  Desenvolvedores e assistentes de IA podem rapidamente enumerar buckets e objetos disponíveis para analisar e auditar o inventário de dados.
• Recuperação de Dados para Fluxos de IA
  LLMs e scripts de automação podem buscar arquivos ou metadados para análise, treinamento ou processamento adicional.
• Gerenciamento Eficiente de Conteúdo
  Permite aos usuários gerenciar grandes coleções de arquivos, suportando operações como listagem, filtragem e busca de detalhes de objetos via ferramentas padronizadas.
• Integração com Aplicações Inteligentes de Negócio
  Combina com outros produtos MCP da Volcengine para construir fluxos de trabalho orientados a dados, como autoindexação, busca e recomendação de conteúdo.
• Relatórios Automatizados e Auditoria
  Lista e verifica regularmente conteúdos de armazenamento para apoiar requisitos de compliance e monitoramento.

Como configurar

Windsurf

1. Certifique-se de que o Node.js está instalado em seu sistema.
2. Abra o arquivo de configuração do Windsurf.
3. Adicione o TOS MCP Server à seção mcpServers utilizando o seguinte JSON:

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

4. Salve a configuração e reinicie o Windsurf.
5. Verifique a configuração executando uma consulta MCP de teste no Windsurf.

Claude

1. Verifique se o Node.js está instalado.
2. Vá até o diretório de configuração da ferramenta Claude.
3. Insira o TOS MCP Server sob mcpServers:

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

4. Salve as alterações e reinicie o Claude.
5. Confirme a conectividade emitindo um prompt de exemplo.

Cursor

1. Certifique-se de que o Node.js está disponível.
2. Localize o arquivo de configuração do Cursor.
3. Adicione o TOS MCP Server no array mcpServers:

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

4. Salve e reinicie o Cursor.
5. Teste a configuração com um prompt que liste os buckets.

Cline

1. Instale o Node.js se não estiver presente.
2. Abra o arquivo de configuração do Cline para MCP servers.
3. Adicione o TOS MCP Server:

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

4. Salve e reinicie o Cline.
5. Verifique listando os recursos do TOS.

Protegendo as chaves de API:
Armazene credenciais sensíveis como variáveis de ambiente. Exemplo:

{
  "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"
      }
    }
  }
}

Como usar este MCP em fluxos

Utilizando o MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

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

Após configurar, o agente de IA estará apto a utilizar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de alterar “tos-mcp” para o nome real do seu servidor MCP e substituir a URL pela sua URL do servidor MCP.

Visão Geral

Nossa opinião

Este MCP server oferece documentação clara e ferramentas práticas para interagir com recursos de armazenamento TOS. Ele suporta uma variedade de casos de uso, desde listagem simples de recursos até integração em fluxos inteligentes. No entanto, a documentação não menciona suporte a Roots ou Sampling.

Com base nas tabelas acima, eu classificaria este MCP server como 7/10: possui funcionalidades sólidas e instruções, mas falta clareza sobre recursos avançados de MCP como Roots e Sampling, além de não possuir um arquivo LICENSE.

Pontuação MCP