masv

Servidor MCP MASV

⚠️ Servidor Experimental: Este é um servidor MCP experimental criado para avaliar o interesse e o potencial de integração. Ele não foi submetido aos nossos rigorosos processos internos de verificação. Suporte e atualizações adicionais serão fornecidos com base no melhor esforço. Queremos ouvir você! Se tiver dúvidas ou problemas, entre em contato conosco em support@masv.io.

Um servidor MCP (Model Context Protocol) que fornece ferramentas para LLMs interagirem com a API MASV.

O que é MASV?

MASV é um serviço de transferência de arquivos gerenciado, fácil de usar e ultraconfiável, projetado para equipes de todos os tamanhos. Ele permite que os usuários enviem e recebam arquivos massivos sem limites de tamanho, garantindo integridade e segurança dos dados por meio de sua infraestrutura robusta em nuvem, que suporta fluxos de trabalho em nuvem, locais e híbridos.

Saiba mais https://masv.io/

Instalação

O servidor pode ser executado diretamente com npx sem instalação, ou instalado globalmente, se preferir:

# Run directly with npx (recommended)
npx @getmasv/masv-mcp-server

# Or install globally
npm install -g @getmasv/masv-mcp-server

Configuração

Variáveis de Ambiente Obrigatórias

O servidor requer as seguintes variáveis de ambiente para autenticar com a API MASV:

• MASV_TEAM_ID - Seu identificador de equipe MASV
• MASV_API_KEY - Sua chave de autenticação da API MASV

Variáveis de Ambiente Opcionais

• MASV_ALLOW_DELETE - Defina como true para permitir que o LLM use ferramentas de exclusão de pacotes e portais (padrão: false)

Configuração do Cliente MCP

Adicione o servidor ao seu arquivo de configuração do cliente MCP:

{
  "mcpServers": {
    "masv": {
      "command": "npx",
      "args": ["-y", "@getmasv/masv-mcp-server"],
      "env": {
        "MASV_TEAM_ID": "your-team-id",
        "MASV_API_KEY": "your-api-key"
      }
    }
  }
}

Nota: O sinalizador -y confirma automaticamente a execução do pacote sem solicitação.

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas para interação com LLM:

Gerenciamento de Pacotes

• get_packages - Listar pacotes da equipe
• get_package - Obter detalhes do pacote por ID
• get_portal_packages - Listar pacotes enviados para portais
• get_package_files - Listar arquivos em um pacote
• get_package_transfers - Obter histórico de transferência do pacote
• update_package_expiration_date_and_time - Modificar expiração do pacote
• delete_package - Excluir um pacote (requer MASV_ALLOW_DELETE=true)

Gerenciamento de Portais

• get_portals - Listar todos os portais
• get_portal - Obter detalhes do portal por ID
• create_portal - Criar um novo portal
• update_portal - Atualizar configuração do portal
• delete_portal - Excluir um portal (requer MASV_ALLOW_DELETE=true)

Rastreamento de Atividades

• get_activities - Listar atividades e eventos
• get_activity_events - Obter histórico de eventos de uma atividade
• get_activities_information - Obter descrições detalhadas do estado da atividade

Gerenciamento de Integrações

• get_integrations - Listar integrações de armazenamento conectadas
• send_package_to_integration - Transferir pacote para armazenamento conectado
• list_files_on_integration - Navegar por arquivos em integrações em nuvem
• list_files_on_storage_gateway - Navegar por arquivos no Storage Gateway
• transfer_files_from_integration - Transferir arquivos do armazenamento para MASV (funciona com nuvem e MASV Storage Gateway)

Gerenciamento de Equipe

• get_team_members - Listar membros da equipe e seus detalhes

Licença

MIT

Suporte

Para dúvidas, problemas ou feedback, entre em contato conosco em support@masv.io.

Desenvolvimento

Instalar dependências

npm install

Compilar

npm run build

Usar o servidor MCP

No aplicativo de chat LLM, adicione o comando para iniciar o servidor:

node /path/to/masv-mcp-server/build/index.js

Para executar o inspetor MCP e inspecionar e executar ferramentas

npm run inspector