Transportes de servidor MCP

Visão geral

Feedback
• Transporte STDIO (servidores locais)
Feedback
• Transporte HTTP Streamable (padrão moderno para servidores remotos)
Feedback
• Transporte SSE (removido)

Transporte STDIO

Como o transporte STDIO funciona

Feedback
1. Bob gera um servidor MCP como um processo filho
Feedback
2. A comunicação acontece através de fluxos de processo: Bob escreve no STDIN do servidor, o servidor responde no STDOUT
Feedback
3. Cada mensagem é delimitada por um caractere de nova linha
Feedback
4. As mensagens são formatadas como JSON-RPC 2.0

Cliente                   Servidor
  |                         |
  |---- mensagem JSON ----->| (via STDIN)
  |                         | (processa solicitação)
  |<---- mensagem JSON -----| (via STDOUT)
  |                         |

Características do STDIO

Feedback
• Localidade: Executa na mesma máquina que Bob
Feedback
• Desempenho: Latência e sobrecarga muito baixas (sem pilha de rede envolvida)
Feedback
• Simplicidade: Comunicação direta de processo sem configuração de rede
Feedback
• Relacionamento: Relacionamento um-para-um entre cliente e servidor
Feedback
• Segurança: Inerentemente mais seguro sem exposição de rede

Quando usar STDIO

Feedback
• Integrações locais e ferramentas executando na mesma máquina
Feedback
• Operações sensíveis à segurança
Feedback
• Requisitos de baixa latência
Feedback
• Cenários de cliente único (uma instância Bob por servidor)
Feedback
• Ferramentas de linha de comando ou extensões de IDE

Exemplo de implementação STDIO

const server = new Server({name: 'local-server', version: '1.0.0'});
// Registrar ferramentas...

// Usar transporte STDIO
const transport = new StdioServerTransport(server);
transport.listen();

Transporte HTTP Streamable

Como o transporte HTTP Streamable funciona

Feedback
1. O servidor fornece um único endpoint HTTP (endpoint MCP) que suporta métodos POST e GET
Feedback
2. Bob envia solicitações para este endpoint MCP usando HTTP POST
Feedback
3. O servidor processa a solicitação e envia de volta uma resposta
Feedback
4. Opcionalmente, o servidor pode usar Server-Sent Events (SSE) sobre a mesma conexão para transmitir múltiplas mensagens ou notificações ao Bob

Cliente                            Servidor
  |                                  |
  |---- HTTP POST /mcp_endpoint ---->| (solicitação do cliente)
  |                                  | (processa solicitação)
  |<--- Resposta HTTP / Stream SSE --| (resposta do servidor / stream)
  |                                  |

Características do HTTP Streamable

Feedback
• Padrão moderno: Método preferido para novas implementações de servidor MCP remoto
Feedback
• Acesso remoto: Pode ser hospedado em uma máquina diferente do Bob
Feedback
• Escalabilidade: Pode lidar com múltiplas conexões de cliente simultaneamente
Feedback
• Protocolo: Funciona sobre HTTP/HTTPS padrão
Feedback
• Flexibilidade: Suporta solicitação-resposta simples e streaming avançado
Feedback
• Endpoint único: Usa um único caminho de URL para toda comunicação MCP
Feedback
• Autenticação: Pode usar mecanismos de autenticação HTTP padrão
Feedback
• Compatibilidade retroativa: Servidores podem manter compatibilidade com clientes HTTP+SSE mais antigos

Quando usar HTTP Streamable

Feedback
• Todos os novos desenvolvimentos de servidor MCP remoto
Feedback
• Servidores que requerem comunicação robusta, escalável e flexível
Feedback
• Integrações que podem envolver streaming de dados ou notificações enviadas pelo servidor
Feedback
• Serviços públicos ou ferramentas centralizadas
Feedback
• Substituição de implementações de transporte SSE legado

Negociação de protocolo

{
  "mcpServers": {
    "my-server": {
      "url": "https://your-server-url.com/mcp",
      "protocolNegotiation": "legacy"
    }
  }
}

Exemplo de implementação HTTP Streamable

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Compatibilidade retroativa com HTTP+SSE

Transporte SSE (removido)

Migrar do transporte SSE

Feedback
• HTTP Streamable: Expõe um único endpoint MCP que aceita pedidos HTTP POST. É o caminho recomendado para servidores remotos. Consulta Transporte HTTP Streamable.
Feedback
• STDIO: Se o servidor corre localmente na mesma máquina que o Bob, converte-o para um servidor STDIO. Consulta Transporte STDIO.

Considerações de implantação

STDIO: Implantação local

Feedback
• Instalação: O executável do servidor deve ser instalado na máquina de cada usuário
Feedback
• Distribuição: Você precisa fornecer pacotes de instalação para diferentes sistemas operacionais
Feedback
• Atualizações: Cada instância deve ser atualizada separadamente
Feedback
• Recursos: Usa CPU, memória e disco da máquina local
Feedback
• Controle de acesso: Depende das permissões do sistema de arquivos da máquina local
Feedback
• Integração: Fácil integração com recursos do sistema local (arquivos, processos)
Feedback
• Execução: Inicia e para com Bob (ciclo de vida de processo filho)
Feedback
• Dependências: Quaisquer dependências devem ser instaladas na máquina do usuário

Feedback
• Executa na máquina do usuário
Feedback
• Tem acesso direto ao sistema de arquivos local
Feedback
• Inicia quando necessário pelo Bob
Feedback
• Não requer configuração de rede
Feedback
• Precisa ser instalada junto com Bob ou via gerenciador de pacotes

Remoto: Implantação hospedada

Feedback
• Instalação: Instalado uma vez em um servidor, acessado por muitos usuários
Feedback
• Distribuição: Implantação única serve múltiplos clientes
Feedback
• Atualizações: Atualizações centralizadas afetam todos os usuários imediatamente
Feedback
• Recursos: Usa recursos do servidor, não recursos da máquina local
Feedback
• Controle de acesso: Gerenciado através de sistemas de autenticação e autorização
Feedback
• Integração: Integração mais complexa com recursos específicos do usuário
Feedback
• Execução: Executa como um serviço independente (frequentemente continuamente)
Feedback
• Dependências: Gerenciadas no servidor, não nas máquinas dos usuários

Feedback
• Executa em um servidor central
Feedback
• Conecta-se a bancos de dados com credenciais do lado do servidor
Feedback
• Está continuamente disponível para múltiplos usuários
Feedback
• Requer configuração adequada de segurança de rede
Feedback
• É implantada usando tecnologias de contêiner ou nuvem

Abordagens híbridas

Feedback
1. STDIO com acesso à rede: Um servidor STDIO local que atua como proxy para serviços remotos
Feedback
2. Remoto com comandos locais: Um servidor remoto que pode acionar operações na máquina cliente através de callbacks
Feedback
3. Padrão de gateway: Servidores STDIO para operações locais que se conectam a servidores remotos para funções especializadas

Comparação de transportes

Configurar transportes no Bob