workshop-27-08-26

Exemplo de servidor MCP para o workshop do bootcamp AWS AI FDE for Commerce de 27/08/2026

O que é MCP?

O MCP (Model Context Protocol) é um protocolo open-source de comunicação entre sistemas, que permite a troca de informações de dados/contexto entre diferentes aplicações (Majoritariamente de IA).

Usando esse protocolo, é possível que um sistema de IA (como uma aplicação de agentes) consuma/disponibilize informações contextuais de/para outro sistema, permitindo que modelos operem com mais certeza e relevância.

Usando a analogia do USB-C:

Pense no MCP como uma porta USB-C para aplicações de IA. Assim como o USB-C fornece uma maneira padronizada de conectar dispositivos eletrônicos, o MCP fornece uma maneira padrão de conectar aplicações de IA a outros sistemas.

Related MCP server: Basic MCP Server

Opções de SDK

O protocolo suporta diferentes opções de SDKs (Software Development Kits), que podem ser usados para implementar MCP em diferentes linguagens/frameworks.

Encontre a lista completa aqui: Available SDKs

Opções de Transporte

Focando no contexto do workshop, vamos explorar as opções de transporte mais comuns/populares para Node.js:

stdio

Faça o servidor MCP rodar como um processo filho, envie e receba mensagens via stdin e stdout.

Serve over stdio

HTTP

Disponibilize um servidor, que recebe e envia mensagens via requisições HTTP para diversos clientes simultaneamente.

Serve over HTTP

Frameworks

Use de tecnologias/frameworks de Node.js para facilitar a implementação do protocolo MCP, como:

• Express

• Fastify

• Hono

Cenário do Workshop

Cliente Nordesul

1. Considere um projeto de e-commerce em um grande cliente, com uma equipe de 20 desenvolvedores alocados para fazer a migração de sua loja virtual legada (V0) para um framework mais moderno (V1). O objetivo é que a loja virtual V1 seja idêntica a V0, mas use melhorias de performance do V1.

2. Como diversos desenvolvedores atuarão na mesma base de código, é primordial que as entregas possuam a melhor padronização e qualidade possíveis, seguindo as normas e identidade da nossa companhia.

3. O cliente possui uma base de dados com documentações de todas as suas APIs, que estão em um endpoint compartilhado com a equipe de desenvolvimento para consulta.

Este Repositório

Este repositório contém um template de servidor MCP, que pode ser usado para:

• Entender a implementação dos transportes stdio e HTTP com @modelcontextprotocol/server;

• Simular a comunicação entre sistemas de IA e qualquer serviço externo;

• Servir como inspiração para a implementação de um servidor MCP real;

• Ser a porta de entrada para o uso de Agentes de IA com tools customizadas.

Estrutura do Repositório

/servers

Servidores MCP de exemplo, usando diferentes transportes e frameworks.

• /servers/stdio

Serve mensagens MCP via stdin e stdout, como um processo filho.

• /servers/http

Serve mensagens MCP via requisições HTTP, usando apenas o módulo HTTP nativo do Node.js.

• /servers/express

Serve mensagens MCP via requisições HTTP, usando o framework Express.

/tools

Exemplos de tools customizadas, que podem ser usadas por Agentes de IA para interagir com outros sistemas.

• /tools/index.js

Centraliza e exporta todas as tools do repositório, para que os servidores MCP possam registrá-las de forma unificada.

• /tools/nordesul-deploy

Retorna cuidados e boas práticas essenciais para um deploy seguro no cliente Nordesul.

• /tools/nordesul-delivery

Simula padrões e contratos de implementação para o projeto.

• /tools/nordesul-reference

Simula a consulta de uma documentação de API no cliente Nordesul.

• /tools/nordesul-status

Simula a consulta do status de uma aplicação no cliente Nordesul.

/utils

Centraliza funções utilitárias/compartilhadas do projeto.

/.opencode

Diretório de configuração do Opencode, contém um agente custom mentor, para auxiliar os participantes do workshop a entenderem o repositório e suas funcionalidades.

Rodando o Projeto

Pré-requisitos

• Git;

• Clonar o repositório do workshop;

• Opencode (Ou qualquer outro agente de IA que suporte MCP) instalado e configurado;

• Node.js (>= LTS Preferido)

• Gerenciador de Pacotes (npm ou yarn)

Instalando as Dependências

Na raíz do projeto, rode o comando:

npm install

# ou:

yarn install

Instalando Opencode

Em qualquer diretório, rode o comando:

npm i -g opencode-ai

Rodando os Servidores

Servidor MCP via stdio:

npm run start:stdio

# ou:

yarn start:stdio

Servidor MCP via http:

npm run start:http

# ou:

yarn start:http

Servidor MCP via integração com Express:

npm run start:express

# ou:

yarn start:express

Rodando o Agente Mentor (Exemplo com Opencode)

Com o Opencode instalado, abra um terminal de sua preferência no diretório do repositório e rode o comando:

opencode

A primeira execução irá baixar todas as dependências do Opencode, então aguarde a conclusão do processo. O agente Mentor já estará selecionado por padrão.

Integração de servidores MCP com Agentes de IA

• Opencode: MCP servers;

• Claude: Connect Claude Code to tools via MCP;

• Codex: Model Context Protocol;

• Cursor: Model Context Protocol (MCP);

• Antigravity: Model Context Protocol (MCP).

Prompts de Exemplo

Alguns exemplos para interagir com as tools do repositório, usando o seu agente:

nordesul-delivery

Quais são os padrões de implementação para a área de checkout do Nordesul?

nordesul-deploy

Antes de eu publicar essa mudança no Nordesul, quais cuidados devo tomar?

nordesul-reference

Me mostra a documentação da API de pedidos (orders) do Nordesul.

nordesul-status

Qual o status atual da aplicação checkout-service no Nordesul?

📚 Material de Apoio

A pasta material-adicional/ contém documentação complementar para o workshop.

Leitura Recomendada (Antes ou Durante)

Leitura Opcional (Aprofundamento)

Catálogo de APIs Públicas

Para o hands-on, escolha uma API do catálogo:

🔗 https://www.freepublicapis.com/tags/popular

APIs sugeridas (sem autenticação):

• Open Meteo — Clima

• Free Meal API — Receitas

• HackerNews — Notícias de tech

• World Bank — Dados econômicos