Swapi Mcp Server App

📖 Sobre o Projeto

Este projeto é um servidor MCP desenvolvido em TypeScript que integra a Star Wars API (SWAPI) com o Claude Desktop. Ele permite que você faça perguntas sobre o universo Star Wars e obtenha informações detalhadas sobre personagens, planetas, filmes e muito mais, diretamente através do Claude.

✨ Funcionalidades

🔧 Tools Disponíveis

• search_characters - Busca personagens do Star Wars por nome
• search_planets - Busca planetas do Star Wars por nome
• search_films - Busca filmes do Star Wars por título
• get_character_by_id - Obtém informações detalhadas de um personagem pelo ID

📚 Resources Disponíveis

• all_films - Lista todos os filmes da saga Star Wars ordenados por episódio

🚀 Como Executar

Pré-requisitos

• Node.js (versão 18 ou superior)
• Claude Desktop instalado
• npm ou yarn

1. Instalação

# Clone o repositório
git clone https://github.com/glaucia86/swapi-mcp-server-app.git

# Entre no diretório
cd swapi-mcp-server-app

# Instale as dependências
npm install

2. Compilação

# Compile o TypeScript
npm run build

3. Configuração do Claude Desktop

1. Localize o arquivo de configuração:

   %APPDATA%\Claude\claude_desktop_config.json
   

2. Adicione a configuração do servidor MCP:

   {
     "mcpServers": {
       "swapi-mcp-server": {
         "command": "node",
         "args": ["CAMINHO_COMPLETO/swapi-mcp-server-app/build/index.js"]
       }
     }
   }
   

   ⚠️ Importante: Substitua CAMINHO_COMPLETO pelo caminho absoluto para o seu projeto.

3. Reinicie o Claude Desktop completamente

4. Verificação

O servidor será iniciado automaticamente pelo Claude Desktop. Você saberá que está funcionando quando conseguir fazer perguntas sobre Star Wars no Claude.

🧪 Testando com o Inspector

Para testar e debugar o servidor MCP, você pode usar o MCP Inspector:

# Execute o inspector
npm run inspector

O inspector abrirá em seu navegador onde você poderá:

• Testar todos os tools individualmente
• Verificar os resources disponíveis
• Debugar problemas de conexão
• Visualizar logs em tempo real

💬 Exemplos de Perguntas

Buscar Personagens

Busque informações sobre Luke Skywalker

Procure pelo personagem Darth Vader

Encontre dados sobre a Princesa Leia

Buscar Planetas

Encontre informações sobre o planeta Tatooine

Busque dados sobre Alderaan

Procure pelo planeta Hoth

Buscar Filmes

Procure pelo filme "A New Hope"

Busque informações sobre "The Empire Strikes Back"

Encontre dados do filme "Return of the Jedi"

Obter Personagem por ID

Obtenha informações do personagem com ID 1

Busque dados do personagem com ID 4

Listar Filmes

Liste todos os filmes de Star Wars

Mostre todos os filmes da saga Star Wars ordenados por episódio

📁 Estrutura do Projeto

swapi-mcp-server-app/
├── src/
│   ├── index.ts          # Servidor MCP principal
│   └── types.ts          # Definições de tipos TypeScript
├── build/                # Arquivos compilados
├── package.json          # Dependências e scripts
├── tsconfig.json         # Configuração do TypeScript
└── README.md             # Documentação

🛠 Scripts Disponíveis

• npm run build - Compila o TypeScript
• npm run watch - Compila em modo watch
• npm run inspect - Executa o MCP Inspector para testes

🔍 Troubleshooting

O servidor não aparece no Claude Desktop

1. Verifique se o caminho no arquivo de configuração está correto
2. Certifique-se de que o arquivo build/index.js existe
3. Reinicie o Claude Desktop completamente
4. Verifique os logs em %APPDATA%\Claude\logs\mcp.log

Erros de compilação

1. Execute npm install novamente
2. Verifique se a versão do Node.js é compatível
3. Execute npm run build e verifique se há erros

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para:

1. Fazer fork do projeto
2. Criar uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abrir um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👨‍💻 Autor

🌟 Agradecimentos

• Star Wars API (SWAPI) - pela API incrível
• Model Context Protocol - pelo protocolo inovador
• Anthropic - pelo Claude Desktop

---