Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/search.handlers.ts:57-62 (handler)

  Core handler function that executes the search_academic tool by parsing arguments and calling the Naver academic search client method.

  /**
   * 전문자료 검색 핸들러
   */
  export async function handleAcademicSearch(params: SearchArgs) {
    return client.searchAcademic(params);
  }

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

  MCP server registration of the search_academic tool, including description, input schema, and invocation of the handler.

  server.registerTool(
    "search_academic",
    {
      description:
        "🎓 Search academic papers, research documents, and scholarly content. Access Korean academic resources, research papers, theses, and professional publications. For recent publications or current research, use get_current_korean_time first. (네이버 전문자료 검색 - 학술 논문과 전문 자료, 최근 발표나 현재 연구를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
      inputSchema: SearchArgsSchema.shape,
    },
    async (args) => {
      const result = await searchToolHandlers.search_academic(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }
  );

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

  Zod input schema used for validating arguments to the search_academic tool.

  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/clients/naver-search.client.ts:80-87 (helper)

  Client helper method that makes the HTTP GET request to Naver's academic document search API endpoint (/doc).

  /**
   * 전문자료 검색 메서드
   */
  async searchAcademic(
    params: NaverDocumentSearchParams
  ): Promise<NaverDocumentSearchResponse> {
    return this.get(`${this.searchBaseUrl}/doc`, params);
  }