IPMA Weather Server

Instructions

Implementation Reference

• src/index.js:301-337 (handler)

  The main handler function for the 'get_locations' tool. Fetches location data from the IPMA API, groups locations by district, formats them into a markdown text response, and returns it in the MCP content format.

  async getLocations() {
    try {
      const response = await fetch(`${this.baseUrl}/distrits-islands.json`);
      const data = await response.json();
  
      let result = "**Locais Disponíveis para Previsão**\n\n";
      
      const groupedByDistrict = {};
      
      data.data.forEach((location) => {
        if (!groupedByDistrict[location.idDistrito]) {
          groupedByDistrict[location.idDistrito] = [];
        }
        groupedByDistrict[location.idDistrito].push(location);
      });
  
      Object.values(groupedByDistrict).forEach((locations) => {
        result += `**Região ${locations[0].idDistrito}:**\n`;
        locations.forEach((loc) => {
          result += `${loc.local} (${loc.latitude}, ${loc.longitude})\n`;
        });
        result += "\n";
      });
  
      return {
        content: [
          {
            type: "text",
            text: result
          }
        ]
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      throw new McpError(ErrorCode.InternalError, `Erro ao obter locais: ${errorMessage}`);
    }
  }

• src/index.js:74-81 (registration)

  Registers the 'get_locations' tool in the list of tools returned by ListToolsRequestSchema, including its name, description, and input schema.

  {
    name: "get_locations",
    description: "Listar todas as cidades/locais disponíveis para previsão",
    inputSchema: {
      type: "object",
      properties: {}
    }
  },

• src/index.js:77-80 (schema)

  Defines the input schema for the 'get_locations' tool, which requires no parameters (empty properties).

  inputSchema: {
    type: "object",
    properties: {}
  }

• src/index.js:114-115 (handler)

  Part of the CallToolRequestSchema handler that dispatches calls to the 'get_locations' tool by invoking the getLocations() method.

  case "get_locations":
    return await this.getLocations();