Star Wars MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Star Wars MCP Server search for Luke Skywalker"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🌟 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.
Related MCP server: starwars
✨ 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 install2. Compilação
# Compile o TypeScript
npm run build3. Configuração do Claude Desktop
Localize o arquivo de configuração:
%APPDATA%\Claude\claude_desktop_config.jsonAdicione 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 inspectorO 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 SkywalkerProcure pelo personagem Darth VaderEncontre dados sobre a Princesa LeiaBuscar Planetas
Encontre informações sobre o planeta TatooineBusque dados sobre AlderaanProcure pelo planeta HothBuscar 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 1Busque dados do personagem com ID 4Listar Filmes
Liste todos os filmes de Star WarsMostre 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.jsexisteReinicie o Claude Desktop completamente
Verifique os logs em
%APPDATA%\Claude\logs\mcp.log
Erros de compilação
Execute
npm installnovamenteVerifique 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! ⭐
Available Tools
4 toolsget_character_by_idObter Personagem por IDB
Obtém informações detalhadas de um personagem pelo ID
Inputs: id (required).
search_charactersBuscar PersonagensC
Busca personagens do Star Wars por nome
Inputs: search (required).
search_filmsBuscar FilmesC
Busca filmes do Star Wars por título
Inputs: search (required).
search_planetsBuscar PlanetasC
Busca planetas do Star Wars por nome
Inputs: search (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: get_character_by_id retrieves a specific character by ID, search_characters searches characters by name, search_films searches films by title, and search_planets searches planets by name. There is no overlap or ambiguity between these functions.
All tool names follow a consistent verb_noun pattern with snake_case: get_character_by_id, search_characters, search_films, and search_planets. The naming is predictable and uniform throughout the set.
With only 4 tools, the server feels thin for a Star Wars domain that includes characters, films, planets, species, starships, and vehicles. While the tools cover basic search and retrieval, the count is borderline low for comprehensive coverage.
The tool set has significant gaps: it lacks CRUD operations (e.g., no create, update, or delete), misses key resources like species and starships, and offers only search and get functions without lifecycle coverage. This will likely cause agent failures for broader tasks.
Maintenance
Related MCP Connectors
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Use your connected apps from your agent: search synced data, act in apps and set up automations.
Web search, scraping, Google Trends and data lookups. Paid per call in USDC on Base via x402.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables searching characters, planets, and films from the Star Wars universe via the SWAPI API.48 npm1ISC
- AlicenseNot gradedqualityDmaintenanceProvides access to the SWAPI Star Wars API, enabling users to query characters, planets, films, species, vehicles, and starships with automatic pagination and caching.18 npm10MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs and clients to search for Star Wars characters, planets, and films by exposing SWAPI as MCP tools.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for querying the Star Wars universe via the SWAPI API, providing access to characters, films, starships, vehicles, species, and planets.ISC