Skip to main content
Glama
Star Wars MCP Server

Star Wars MCP Server

by glaucia86

🌟 Star Wars MCP Server

TypeScript Node.js MCP Star Wars API Claude Desktop

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 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

Glaucia Lemos

Twitter LinkedIn YouTube GitHub

🌟 Agradecimentos


May the Force be with you! ⭐

Available Tools

4 tools
get_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

    B3.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers