Server Swapy

Servidor MCP (Model Context Protocol) para consultas ao universo Star Wars via SWAPI. Ideal para integrações, estudos e demonstrações de arquitetura em camadas com Node.js/TypeScript.

Sumário

• MCP Server - Star Wars API
  • Sumário
  • Sobre o Projeto
  • Pré-requisitos
  • Como executar
  • Scripts disponíveis
  • Sobre a SWAPI
    • Exemplos de uso da API
  • Contribuição
  • Licença
  • Créditos

Sobre o Projeto

• Inspirado no projeto base do canal Código Fonte TV (veja créditos abaixo).
• Reimplementado para consumir a API pública SWAPI, trazendo informações sobre personagens, filmes, naves, veículos, espécies e planetas do universo Star Wars.
• Desenvolvido em Node.js/TypeScript, seguindo arquitetura em camadas (DDD):
  • Domain: Modelos de domínio.
  • Infrastructure: Serviços de integração com a SWAPI.
  • Application: Lógica de negócio e formatação dos dados.
  • Interface: Controladores MCP e validação de entrada.
  • main.ts: Ponto de entrada do servidor MCP.

Pré-requisitos

• Node.js (>= 18)
• Yarn

Como executar

1. Instale as dependências:

   yarn install
   

2. Faça o build do projeto:

   yarn build
   

3. Configure o client para se comunicar com mcp-server, mais informações, clique aqui.

O servidor ficará disponível via stdio, pronto para receber requisições MCP.

Scripts disponíveis

Os principais scripts configurados no package.json para uso com Yarn são:

• yarn build: Compila o projeto TypeScript para JavaScript na pasta build/.
• yarn test: Executa os testes automatizados com Jest.

Você pode rodar os scripts assim:

yarn build   # Compila o projeto
yarn test    # Executa os testes

Sobre a SWAPI

A SWAPI é uma API REST aberta, sem autenticação, que fornece dados do universo Star Wars. Principais recursos disponíveis:

• People (/people/): Personagens icônicos como Luke Skywalker, Darth Vader, etc.
• Films (/films/): Informações sobre os filmes da saga.
• Starships (/starships/): Naves espaciais.
• Vehicles (/vehicles/): Veículos terrestres e aéreos.
• Species (/species/): Espécies do universo Star Wars.
• Planets (/planets/): Planetas famosos como Tatooine, Hoth, Naboo, etc.

Exemplos de uso da API

• Buscar um personagem:

  curl https://swapi.bry.com.br/api/people/1/
  # Retorna dados de Luke Skywalker
  

• Buscar um planeta:

  curl https://swapi.bry.com.br/api/planets/1/
  # Retorna dados de Tatooine
  

• Buscar por nome:

  curl "https://swapi.bry.com.br/api/people/?search=leia"
  # Busca personagens com nome contendo 'leia'
  

Contribuição

Contribuições são bem-vindas! Para contribuir:

• Faça um fork do projeto
• Crie uma branch com sua feature ou correção
• Envie um pull request
• Abra issues para sugestões ou bugs

Licença

Distribuído sob a licença ISC. Veja o arquivo LICENSE para mais detalhes.

Créditos

Este projeto foi baseado no exemplo do canal Código Fonte TV, adaptado para consumir a SWAPI.

Para mais detalhes sobre a SWAPI, acesse a documentação oficial.

Feito com ☕ por Gustavo Freitas. Dúvidas ou sugestões: LinkedIn