LLM을 위한 국립국어원 표준국어대사전 MCP 서버

읽을거리&정보공유
1

1. 프로젝트 소개

《표준국어대사전》 공식 JSON 덤프를 내려받아 SQLite로 정규화한 뒤, Claude나 Cursor 등의 클라이언트에서 MCP(Model Context Protocol) 도구로 조회할 수 있게 해주는 Deno 서버입니다.

2. 주요 특징

  • Open API 키 불필요: 번거로운 국립국어원 API 키 발급 없이, 공식 “사전 내려받기” 덤프를 직접 활용합니다.

  • 로컬 DB 구축 및 캐싱: 최초 기동 시 덤프를 다운로드하여 SQLite로 초기화하며, 이후에는 로컬 ZIP 캐시와 정규화된 DB를 재사용합니다.

  • 유연하고 효율적인 검색: 표제어 중심 검색(exact/prefix/contains)을 지원하며, 조회 시 필요한 필드(예: 표제어와 뜻풀이)만 선택해 LLM의 컨텍스트 사용량을 최적화할 수 있습니다.

  • 실행 환경: Deno 2.0 이상 환경에서 stdio 방식으로 동작합니다.

3. 제공하는 MCP 도구

  • search_entries: 표제어 검색

  • get_entry: target_code 기반 상세 조회

  • dictionary_status: 로컬 데이터 상태 조회

  • refresh_dictionary: 공식 덤프를 다시 받아 DB 강제 갱신

4. 클라이언트 설정 예시

JSR 패키지를 통해 간편하게 연동할 수 있습니다.

JSON

{
  "mcpServers": {
    "ko-stdict": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "jsr:@hongminhee/ko-stdict-mcp"
      ]
    }
  }
}

5. 관련 링크

관심 있는 분들의 많은 활용 바랍니다.

1개의 좋아요