Skip to main content
Glama
gustafsilva

mcp-server-swapy

by gustafsilva
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

MCP Server - Star Wars API Yarn License

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

Related MCP server: Simple MCP Server - Star Wars API

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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Star Wars Explorer

    JoaoA1egre
    F
    license
    Not graded
    quality
    D
    maintenance
    A Laravel-based MCP server that enables users to browse, search, and import Star Wars character data from the SWAPI external API into a local database. It facilitates seamless AI interaction with Star Wars lore through structured tools and the Model Context Protocol.
    -

  • SWAPI MCP

    abhishekjkrsna
    F
    license
    B
    quality
    B
    maintenance
    A Model Context Protocol server that exposes Star Wars API data as MCP tools. It enables users to list available categories and retrieve character information.
    3
    26 npm
    -