swapi -app

This MCP server exposes a Star Wars data interface by wrapping the Star Wars API (SWAPI) and presenting it to Claude Desktop as a set of MCP tools. You can query for characters, planets, and films, as well as retrieve detailed information about a specific character by ID. The available tools are: search_characters to find characters by name, search_planets to find planets by name, search_films to find films by title, and get_character_by_id to fetch detailed data for a character by their SWAPI ID. The Resources section also exposes all_films, which lists all Star Wars films ordered by Episode. Use these tools from Claude Desktop by asking natural language questions (e.g., “Busque informações sobre Luke Skywalker” or “Procure pelo filme "A New Hope"").

Prerequisites:

• Node.js 18 or newer
• npm (or yarn)
• Claude Desktop installed

1. Clone the repository

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

2. Instale as dependências

# Entre no diretório
cd swapi-mcp-server-app

# Instale as dependências
npm install

3. Compilação

# Compile o TypeScript
npm run build

4. 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-app": {
      "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. Verifique se o servidor aparece e está respondendo no Claude Desktop.

5. Verificação

O servidor será iniciado automaticamente pelo Claude Desktop. Você saberá que está funcionando quando puder fazer perguntas sobre Star Wars no Claude.

Dicas úteis:

• Garanta que o caminho para build/index.js está correto após a compilação (npm run build)
• Caso o Claude Desktop não reconheça o servidor, verifique o arquivo de configuração e os logs em %APPDATA%/Claude/logs/mcp.log
• Se ocorrerem erros de compilação, execute npm install novamente e confirme a versão do Node.js compatível
• O Inspector MCP pode ser usado via npm run inspector para testar cada ferramenta e ver a lista de recursos disponíveis
• Este servidor usa TypeScript e gera código em build/index.js a partir de src/index.ts; mantenha o build atualizado ao alterar o código

Variáveis de ambiente e opções de configuração podem ser adicionadas sob env no mcp_config; utilize-as para chaves de API ou configurações locais, se necessário.