🌟 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 nomesearch_planets- Busca planetas do Star Wars por nomesearch_films- Busca filmes do Star Wars por títuloget_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
-
Localize o arquivo de configuração:
%APPDATA%\Claude\claude_desktop_config.json -
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_COMPLETOpelo caminho absoluto para o seu projeto. -
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 TypeScriptnpm run watch- Compila em modo watchnpm run inspect- Executa o MCP Inspector para testes
🔍 Troubleshooting
O servidor não aparece no Claude Desktop
- Verifique se o caminho no arquivo de configuração está correto
- Certifique-se de que o arquivo
build/index.jsexiste - Reinicie o Claude Desktop completamente
- Verifique os logs em
%APPDATA%\Claude\logs\mcp.log
Erros de compilação
- Execute
npm installnovamente - Verifique se a versão do Node.js é compatível
- Execute
npm run builde verifique se há erros
🤝 Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para:
- Fazer fork do projeto
- Criar uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - 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! ⭐