Naver Search MCP Server

Instructions

Implementation Reference

• src/index.ts:237-250 (registration)

  Registration of the 'search_local' MCP tool, including description, input schema, and handler that delegates to searchToolHandlers and formats the response as MCP content.

  server.registerTool(
    "search_local",
    {
      description:
        "📍 Search for local businesses, restaurants, and places in Korea. Find location information, reviews, contact details, and business hours for Korean establishments. For current business hours or today's availability, use get_current_korean_time first. (네이버 지역 검색 - 지역 업체와 장소 정보, 현재 영업시간이나 오늘 이용 가능 여부를 확인할 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
      inputSchema: NaverLocalSearchParamsSchema.shape,
    },
    async (args) => {
      const result = await searchToolHandlers.search_local(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/handlers/search.handlers.ts:92-97 (handler)

  Specific handler function for local search that invokes the NaverSearchClient's searchLocal method.

  /**
   * 지역 검색 핸들러
   */
  export async function handleLocalSearch(params: NaverLocalSearchParams) {
    return client.searchLocal(params);
  }

• src/schemas/search.schemas.ts:58-69 (schema)

  Zod input schema definition for the search_local tool parameters, extending the base SearchArgsSchema with local-specific fields.

  // 지역 검색 파라미터
  export const NaverLocalSearchParamsSchema = SearchArgsSchema.extend({
    sort: z
      .enum(["random", "comment"])
      .optional()
      .describe("정렬 방식 (random: 정확도순, comment: 리뷰 많은순)"),
    display: z.number().optional().describe("한 번에 가져올 결과 수 (최대 5)"),
    start: z.number().optional().describe("검색 시작 위치 (최대 1)"),
  });
  export type NaverLocalSearchParams = z.infer<
    typeof NaverLocalSearchParamsSchema
  >;

• src/clients/naver-search.client.ts:89-96 (helper)

  Core helper function in NaverSearchClient that performs the actual HTTP GET request to the Naver local search API endpoint.

  /**
   * 지역 검색 메서드
   */
  async searchLocal(
    params: NaverLocalSearchParams
  ): Promise<NaverLocalSearchResponse> {
    return this.get(`${this.searchBaseUrl}/local`, params);
  }