GBR: EARS-0005 Especificação do Adaptador Universal MCP | Wiki
Documentação de engenharia e especificações técnicas da Gleam-BR.
GBR: EARS-0005 Especificação do Adaptador Universal MCP
*Requisitos Ubíquos (Ubiquitous Requirements)*
-
*UBQ-MCP-01:* A comunicação com o servidor MCP externo *deve* ser 100% não-bloqueante para o Ator
mcp_client_worker, delegando as chamadas bloqueantes de I/O do SO para a infraestrutura de Ports da BEAM.
*Requisitos Orientados a Eventos (Event-Driven Requirements)*
-
*EVD-MCP-01:* Quando a inicialização do
erlang:open_portfor bem sucedida, o Ator *deve* imediatamente despachar a mensagem JSON-RPC de inicialização (initialize) com a lista de capacidades do nosso cliente. -
*EVD-MCP-02:* Quando o REPL interceptar uma intenção de uso de ferramenta cujo dono seja o cliente universal, o REPL *deve* despachar uma mensagem de requisição assíncrona para o
mcp_client_workercontendo o ID de correlação do JSON-RPC e não deve travar o terminal aguardando o retorno.
*Requisitos de Limites / Extremos (Boundary Requirements)*
-
*BND-MCP-01:* O buffer binário do framing de leitura (que aguarda o complemento do
Content-Length) *não deve* ultrapassar o limite configurado (ex: 10MB) para evitar ataques de esgotamento de memória originados por um servidor MCP defeituoso ou malicioso.