Standard Korean Dictionary

What is stdict?

stdict is a Micro-Controller Platform (MCP) server that acts as an interface to the Standard Korean Dictionary. It allows users to programmatically search the dictionary and retrieve detailed entries, making the dictionary's vast content accessible for various applications.

How to use stdict?

To use stdict, you first need to obtain an API key from the Standard Korean Dictionary website. Once you have the API key, you can integrate stdict into your applications. For example, with Claude Desktop, you can configure it by adding a JSON snippet to your claude_desktop_config.json file, specifying the command to run stdict.py and setting your API key as an environment variable.

Key Features of stdict

stdict offers the following key functionalities:

• Search: Allows users to search the dictionary with various parameters, including keywords, request type (XML/JSON), pagination, advanced search options (e.g., target, method, type, part of speech, category, multimedia), and date filters.
• Detail: Provides the ability to retrieve detailed information for a specific dictionary entry using either a word information query or a target code.
• Flexible Output: Supports both XML and JSON response formats for search and detail queries.
• Extensive Search Parameters: Offers a wide range of parameters for precise searches, including part of speech, professional fields, and multimedia presence.

Use Cases of stdict

• Linguistic Research: Researchers can programmatically access and analyze the Standard Korean Dictionary for linguistic studies.
• Educational Tools: Developers can build educational applications that leverage the dictionary's content for learning Korean.
• Natural Language Processing (NLP): Integrate dictionary lookups into NLP pipelines for tasks like text analysis and understanding.
• Content Creation: Assist in content creation by providing quick and accurate dictionary definitions and related information.

FAQ from stdict

Q: How do I get an API key for the Standard Korean Dictionary? A: You can obtain an API key by following the instructions on the official Standard Korean Dictionary API registration page: https://stdict.korean.go.kr/openapi/openApiRegister.do.

Q: What are the licensing terms for the dictionary content? A: The text content is licensed under the Creative Commons Attribution-ShareAlike 2.0 Korea License. Multimedia content has specific licensing that needs to be checked individually. Attribution to the National Institute of Korean Language (국립국어원) is required. For full terms, refer to the official terms of service: https://stdict.korean.go.kr/join/siteTerms.do.

Q: Can I specify the output format for search results? A: Yes, you can specify xml or json as the req_type parameter in your search and detail requests.

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.