Standard Korean Dictionary MCP Server

What is Standard Korean Dictionary MCP Server about?

Provides two main endpoints – search for finding words using a wide range of filters (e.g., part of speech, category, multimedia type, phonetic length) and detail for obtaining full entry information such as headword data and target codes.

How to use Standard Korean Dictionary MCP Server?

1. Obtain an API key from the National Institute of Korean Language.
2. Include the key in every request as the key parameter.
3. Call the search endpoint with required q (query) and optional parameters like req_type, start, num, target, method, type1, type2, pos, cat, etc.
4. Call the detail endpoint with required q, method (either word_info or target_code), and optional req_type.
5. Responses can be requested in xml (default) or json format.

Key features of Standard Korean Dictionary MCP Server

• Flexible search filters: lexical type, origin, part of speech, subject area, multimedia presence, syllable count, update date range, etc.
• Multiple search methods: exact, include, start, end, wildcard.
• Support for both concise (search) and full‑detail (detail) queries.
• Choice of output format (XML or JSON).
• Authentication via a 32‑character hexadecimal API key.

Use cases of Standard Korean Dictionary MCP Server

• Building Korean language learning apps that need dictionary lookup.
• Integrating authoritative Korean word definitions into search engines or chatbots.
• Academic research tools that filter entries by subject category or part of speech.
• Media applications that retrieve multimedia resources (photos, illustrations, audio) linked to dictionary entries.
• Content management systems that require up‑to‑date lexical data with versioning based on update dates.

FAQ from the Standard Korean Dictionary MCP Server

Q: Which request parameter is mandatory? A: The key (API key) and q (search term) are required for all endpoints.

Q: How do I choose the response format? A: Set req_type to json for JSON output; omit or set to xml for XML.

Q: What does the advanced flag do? A: When set to y, additional filtering parameters become active (e.g., type1, type2, pos).

Q: Is there a limit on the number of results? A: num can be set between 10 and 100 (default 10); start ranges from 1 to 1000.

Q: Where can I find licensing details? A: Code is under MIT; dictionary text uses CC BY‑SA 2.0 Korea, and multimedia content follows individual licenses with required attribution to the National Institute of Korean Language.

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 xmljson 선택 요청 타입(기본값 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 xmljson 선택 요청 타입(기본값 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.