Star Wars MCP Server

Um servidor MCP (Model Context Protocol) que fornece acesso Star Wars API (SWAPI) atravs 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 faa perguntas sobre o universo Star Wars e obtenha informaes detalhadas sobre personagens, planetas, filmes e muito mais, diretamente atravs do Claude.

Funcionalidades

Tools Disponveis

• 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 ttulo
• get_character_by_id - Obtm informaes detalhadas de um personagem pelo ID

Resources Disponveis

• all_films - Lista todos os filmes da saga Star Wars ordenados por episdio

Como Executar

Pr-requisitos

• Node.js (verso 18 ou superior)
• Claude Desktop instalado
• npm ou yarn

1. Instalao

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

# Entre no diretrio
cd swapi-mcp-server-app

# Instale as dependncias
npm install

2. Compilao

# Compile o TypeScript
npm run build

3. Configurao do Claude Desktop

1. Localize o arquivo de configurao:

   %APPDATA%\Claude\claude_desktop_config.json
   

2. Adicione a configurao 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. Verificao

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 disponveis
• Debugar problemas de conexo
• Visualizar logs em tempo real

Exemplos de Perguntas

Buscar Personagens

Busque informaes sobre Luke Skywalker

Procure pelo personagem Darth Vader

Encontre dados sobre a Princesa Leia

Buscar Planetas

Encontre informaes sobre o planeta Tatooine

Busque dados sobre Alderaan

Procure pelo planeta Hoth

Buscar Filmes

Procure pelo filme "A New Hope"

Busque informaes sobre "The Empire Strikes Back"

Encontre dados do filme "Return of the Jedi"

Obter Personagem por ID

Obtenha informaes 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 episdio

Estrutura do Projeto

swapi-mcp-server-app/
 src/
    index.ts          # Servidor MCP principal
    types.ts          # Definies de tipos TypeScript
 build/                # Arquivos compilados
 package.json          # Dependncias e scripts
 tsconfig.json         # Configurao do TypeScript
 README.md             # Documentao

Scripts Disponveis

• 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 no aparece no Claude Desktop

1. Verifique se o caminho no arquivo de configurao 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 compilao

1. Execute npm install novamente
2. Verifique se a verso do Node.js compatvel
3. Execute npm run build e verifique se h erros

Contribuio

Contribuies so 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 mudanas (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abrir um Pull Request

Licena

Este projeto est sob a licena MIT. Veja o arquivo LICENSE para mais detalhes.

Autor

Glaucia Lemos

Agradecimentos

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

---

**May the Force be with you! **