🌟 Star Wars MCP Server

Um servidor MCP (Model Context Protocol) que fornece acesso à Star Wars API (SWAPI) através do Claude Desktop

📖 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

2. Compilação

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:

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

Buscar Planetas

Buscar Filmes

Obter Personagem por ID

Listar Filmes

📁 Estrutura do Projeto

🛠 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

Glaucia Lemos

🌟 Agradecimentos

• Star Wars API (SWAPI) - pela API incrível

• Model Context Protocol - pelo protocolo inovador

• Anthropic - pelo Claude Desktop

May the Force be with you! ⭐