Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/search.handlers.ts:39-42 (handler)

  The dispatcher handler for search_encyc tool that logs args, parses with schema, and calls the core search function.

  search_encyc: (args) => {
    console.error("search_encyc called with args:", JSON.stringify(args, null, 2));
    return handleEncycSearch(SearchArgsSchema.parse(args));
  },

• src/schemas/search.schemas.ts:33-41 (schema)

  Zod schema defining input parameters for the search_encyc tool (query, display, start, sort).

  export const SearchArgsSchema = z.object({
    query: z.string().describe("검색어"),
    display: z.number().optional().describe("한 번에 가져올 결과 수 (기본 10)"),
    start: z.number().optional().describe("검색 시작 위치 (기본 1)"),
    sort: z
      .enum(["sim", "date"])
      .optional()
      .describe("정렬 방식 (sim: 유사도, date: 날짜순)"),
  });

• src/index.ts:207-219 (registration)

  MCP server registration for the search_encyc tool, specifying name, description, input schema, and wrapper handler.

  server.registerTool(
    "search_encyc",
    {
      description:
        "📖 Search Naver Encyclopedia for authoritative knowledge and definitions. Best for academic research, getting reliable information, and understanding Korean concepts and terminology. For current definitions or recent updates, use get_current_korean_time for context. (네이버 지식백과 검색 - 신뢰할 수 있는 정보와 정의, 현재 정의나 최근 업데이트를 찾을 때는 get_current_korean_time으로 상황을 파악하세요)",
      inputSchema: SearchArgsSchema.shape,
    },
    async (args) => {
      const result = await searchToolHandlers.search_encyc(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }

• src/handlers/search.handlers.ts:74-76 (helper)

  Core helper function that executes the Naver encyclopedia ('encyc') search via the NaverSearchClient instance.

  export async function handleEncycSearch(params: SearchArgs) {
    return client.search("encyc", params);
  }