Star Wars MCP Server

Instructions

Implementation Reference

• src/index.ts:206-234 (handler)

  Executes the tool logic: fetches character details from SWAPI /people/{id} endpoint using axios, formats the response into a text string with key fields, and returns it as content. Catches errors and calls handleError.

  async ({ id }) => {
    try {
      const response = await this.axiosInstance.get<People>(
        `/people/${id}/`
      );
  
      const char = response.data;
      const characterInfo = `Nome: ${char.name}
        Altura: ${char.height}cm
        Massa: ${char.mass}kg
        Cor do Cabelo: ${char.hair_color}
        Cor dos Olhos: ${char.eye_color}
        Ano de Nascimento: ${char.birth_year}
        Gênero: ${char.gender}
        URL do Mundo Natal: ${char.homeworld}
        Número de Filmes: ${char.films.length}`;
  
      return {
        content: [
          {
            type: "text" as const,
            text: characterInfo,
          },
        ],
      };
    } catch (error) {
      return this.handleError(error, `obter personagem com ID ${id}`);
    }
  }

• src/index.ts:202-204 (schema)

  Input schema using Zod validation: requires a numeric 'id' parameter for the character ID.

  inputSchema: {
    id: z.number().describe("ID do personagem"),
  },

• src/index.ts:197-235 (registration)

  Registers the 'get_character_by_id' tool with the MCP server, providing title, description, input schema, and the handler function.

  this.server.registerTool(
    "get_character_by_id",
    {
      title: "Obter Personagem por ID",
      description: "Obtém informações detalhadas de um personagem pelo ID",
      inputSchema: {
        id: z.number().describe("ID do personagem"),
      },
    },
    async ({ id }) => {
      try {
        const response = await this.axiosInstance.get<People>(
          `/people/${id}/`
        );
  
        const char = response.data;
        const characterInfo = `Nome: ${char.name}
          Altura: ${char.height}cm
          Massa: ${char.mass}kg
          Cor do Cabelo: ${char.hair_color}
          Cor dos Olhos: ${char.eye_color}
          Ano de Nascimento: ${char.birth_year}
          Gênero: ${char.gender}
          URL do Mundo Natal: ${char.homeworld}
          Número de Filmes: ${char.films.length}`;
  
        return {
          content: [
            {
              type: "text" as const,
              text: characterInfo,
            },
          ],
        };
      } catch (error) {
        return this.handleError(error, `obter personagem com ID ${id}`);
      }
    }
  );

• src/types.ts:1-18 (schema)

  TypeScript interface definition for 'People' used to type the SWAPI response in the get_character_by_id handler.

  export interface People {
    name: string;
    height: string;
    mass: string;
    hair_color: string;
    skin_color: string;
    eye_color: string;
    birth_year: string;
    gender: string;
    homeworld: string;
    films: string[];
    species: string[];
    vehicles: string[];
    starships: string[];
    created: string;
    edited: string;
    url: string;
  }