privetin/stdict

Standard Korean Dictionary MCP Server

MCP server for the Standard Korean Dictionary.

Tools

• search
  • Search the dictionary
  • Args:

    검색요청 정보

    요청 변수	타입	허용값	필수/선택	설명
    key	string	16진수 32자리	필수	인증 키
    q	string	-	필수	검색어(UTF-8 인코딩)
    req_type	string	xml json	선택	요청 타입(기본값 xml)
    start	integer	11000	선택	검색의 시작 번호(기본값 1)
    num	integer	10100	선택	결과 출력 건수(기본값 10)
    advanced	string	n y	선택	- 자세히 찾기 여부(기본값 n) y: 자세히 찾기 사용 n: 자세히 찾기 미사용
    ※ 하단의 요청 변수들을 사용하시려면 자세히 찾기 여부(기본값 n)인 "advanced" 요청 변수를 'y'로 하셔야 합니다.
    target	integer	1 ~ 11	선택	- 찾을 대상(기본값 1) 1: 표제어 2: 원어 3: 어원 4: 발음 5: 활용 6: 문형 7: 문법 8: 뜻풀이 9: 용례 10: 용례 출전 11: 용례 번역
    method	string	exact include start end wildcard	선택	- 검색 방식(기본값: exact) exact: 일치 검색 include: 포함 검색 start: 시작 end: 끝 wildcard: 와일드카드 검색
    type1	array of string	all word phrase idiom proverb	선택	- 구분 1(기본값 all) all: 전체 - 아래 값을 다중 선택할 수 있도록 콤마(,)로 구분하여 나열한다. word: 어휘 phrase: 구 idiom: 관용구 proverb: 속담
    type2	array of string	all native chinese loanword hybrid	선택	- 구분 2(기본값 all) all: 전체 - 아래 값을 다중 선택할 수 있도록 콤마(,)로 구분하여 나열한다. native: 고유어 chinese: 한자어 loanword: 외래어 hybrid: 혼종어
    pos	array of integer	015	선택	- 품사(기본값 0) 0: 전체 - 아래 값을 다중 선택할 수 있도록 콤마(,)로 구분하여 나열한다. 1: 명사 2: 대명사 3: 수사 4: 조사 5: 동사 6: 형용사 7: 관형사 8: 부사 9: 감탄사 10: 접사 11: 의존 명사 12: 보조 동사 13: 보조 형용사 14: 어미 15: 품사 없음
    cat	array of integer	067	선택	- 전문 분야(기본값 0) 0: 전체 - 아래 값을 다중 선택할 수 있도록 콤마(,)로 구분하여 나열한다. 1: 언어 2: 문학 3: 역사 4: 철학 5: 교육 6: 민속 7: 인문 일반 8: 법률 9: 군사 10: 경영 11: 경제 12: 복지 13: 정치 14: 매체 15: 행정 16: 심리 17: 사회 일반 18: 지구 19: 지리 20: 해양 21: 천문 22: 환경 23: 생명 24: 동물 25: 식물 26: 천연자원 27: 수학 28: 물리 29: 화학 30: 자연 일반 31: 농업 32: 수산업 33: 임업 34: 광업 35: 공업 36: 서비스업 37: 산업 일반 38: 의학 39: 약학 40: 한의 41: 수의 42: 식품 43: 보건 일반 44: 건설 45: 교통 46: 기계 47: 전기·전자 48: 재료 49: 정보·통신 50: 공학 일반 51: 체육 52: 연기 53: 영상 54: 무용 55: 음악 56: 미술 57: 복식 58: 공예 59: 예체능 일반 60: 가톨릭 61: 기독교 62: 불교 63: 종교 일반 64: 인명 65: 지명 66: 책명 67: 고유명 일반
    multimedia	array of integer	0~6	선택	- 멀티미디어(기본값 0) 0: 전체 - 아래 값을 다중 선택할 수 있도록 콤마(,)로 구분하여 나열한다. 1: 사진 2: 삽화 3: 동영상 4: 애니메이션 5: 소리 6: 없음
    letter_s	integer	1 ~	선택	- 음절 수 시작(기본값 1)
    letter_e	integer	1 ~	선택	- 음절 수 끝(기본값 1)
    update_s	integer	yyyymmdd	선택	- 고친 날짜 시작일
    update_e	integer	yyyymmdd	선택	- 고친 날짜 종료일

• detail
  • Get detailed information about a dictionary entry
  • Args:

    검색 요청 설명

    요청 변수	타입	허용값	필수/선택	설명
    key	string	16진수 32자리	필수	인증 키
    method	string	word_info target_code	필수	-검색 방식(기본값 word_info) word_info: 표제어 정보(표제어 + 어깨번호) target_code: *대상 코드(target_code)
    req_type	string	xml json	선택	요청 타입(기본값 xml)
    q	string	-	필수	검색어(UTF-8 인코딩)

Setup

API Key

Get a Standard Korean Dictionary API Key by following the instructions here.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

UV

{
    "stdict": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/stdict",
            "run",
            "stdict.py"
        ],
        "env": {
            "STDICT_API_KEY": "YOUR_API_KEY"
        }
    }
}

License

Code

This MCP server implementation is provided under the MIT License.

Dictionary Content

Content from the Standard Korean Dictionary is provided under the following terms:

• Text content is licensed under the Creative Commons Attribution-ShareAlike 2.0 Korea License
• Multimedia content (images, videos, sounds etc.) has content-specific licensing that must be checked individually
• Attribution to the National Institute of Korean Language (국립국어원) is required when using dictionary content

For full terms of use, see the official terms of service.