Model Context Protocol Server

Instructions

Implementation Reference

• src/tools/WeatherApiTool.ts:34-91 (handler)

  The handler function that performs geocoding for the city, fetches current weather data from Open-Meteo API, processes the response, and returns formatted weather information.

  async execute({ city }: WeatherApiInput): Promise<WeatherApiResponse> {
    try {
      // 첫째, 도시의 좌표를 가져옵니다
      const geoResponse = await axios.get(this.GEOCODING_URL, {
        params: {
          name: city,
          count: 1,
          language: "en",
          format: "json",
        },
      });
  
      if (!geoResponse.data.results?.length) {
        throw new Error(`도시 '${city}'를 찾을 수 없습니다`);
      }
  
      const location = geoResponse.data.results[0];
  
      // 그런 다음 좌표를 사용하여 날씨 데이터를 가져옵니다
      const weatherResponse = await axios.get(this.WEATHER_URL, {
        params: {
          latitude: location.latitude,
          longitude: location.longitude,
          current: [
            "temperature_2m",
            "relative_humidity_2m",
            "apparent_temperature",
            "precipitation",
            "weather_code",
            "wind_speed_10m",
          ],
          timezone: "auto",
        },
      });
  
      const current = weatherResponse.data.current;
  
      // 날씨 코드에 따라 조건 매핑
      const condition = this.getWeatherCondition(current.weather_code);
  
      return {
        city: location.name,
        temperature: Math.round(current.temperature_2m),
        condition,
        humidity: Math.round(current.relative_humidity_2m),
        windSpeed: Math.round(current.wind_speed_10m),
        feelsLike: Math.round(current.apparent_temperature),
        precipitation: current.precipitation,
      };
    } catch (error: unknown) {
      if (error instanceof Error) {
        throw new Error(`날씨 데이터 가져오기 실패: ${error.message}`);
      }
      throw new Error(
        "날씨 데이터 가져오기 실패: 알 수 없는 오류가 발생했습니다"
      );
    }
  }

• src/tools/WeatherApiTool.ts:27-32 (schema)

  Zod-based input schema defining the 'city' parameter as a required string.

  schema = {
    city: {
      type: z.string(),
      description: "날씨를 가져올 도시 이름",
    },
  };

• src/tools/WeatherApiTool.ts:19-22 (registration)

  Tool class registration extending MCPTool, defining the tool name 'weather_api' and description. Likely auto-registered by the MCP framework.

  class WeatherApiTool extends MCPTool<WeatherApiInput> {
    name = "weather_api";
    description = "Open-Meteo API를 사용하여 도시의 실제 날씨 정보를 가져오기";

• src/tools/WeatherApiTool.ts:93-123 (helper)

  Helper function to map WMO weather codes to human-readable Korean descriptions.

  private getWeatherCondition(code: number): string {
    // WMO 날씨 해석 코드 (https://open-meteo.com/en/docs)
    const conditions: Record<number, string> = {
      0: "맑은 하늘",
      1: "주로 맑음",
      2: "부분적으로 흐림",
      3: "흐림",
      45: "안개",
      48: "서리안개",
      51: "가벼운 이슬비",
      53: "보통 이슬비",
      55: "강한 이슬비",
      61: "약한 비",
      63: "보통 비",
      65: "강한 비",
      71: "약한 눈",
      73: "보통 눈",
      75: "강한 눈",
      77: "눈 알갱이",
      80: "약한 소나기",
      81: "보통 소나기",
      82: "강한 소나기",
      85: "약한 눈소나기",
      86: "강한 눈소나기",
      95: "천둥번개",
      96: "약한 우박을 동반한 천둥번개",
      99: "강한 우박을 동반한 천둥번개",
    };
  
    return conditions[code] || "알 수 없음";
  }

• src/tools/WeatherApiTool.ts:5-17 (schema)

  TypeScript interfaces defining input (WeatherApiInput) and output (WeatherApiResponse) shapes.

  interface WeatherApiInput {
    city: string;
  }
  
  interface WeatherApiResponse {
    city: string;
    temperature: number;
    condition: string;
    humidity: number;
    windSpeed: number;
    feelsLike: number;
    precipitation: number;
  }