국립국어원 표준국어대사전 MCP 서버

What is 국립국어원 표준국어대사전 MCP 서버?

국립국어원 표준국어대사전 MCP 서버는 국립국어원 표준국어대사전 오픈 API를 MCP(Model Context Protocol) 서버로 제공하는 TypeScript 패키지입니다. Claude, ChatGPT 등 대규모 언어 모델이 한국어 사전 정보에 접근하고 활용할 수 있도록 도와줍니다.

How to use 국립국어원 표준국어대사전 MCP 서버?

NPM으로 전역 설치(npm install -g koreandict-mcp-server) 후 명령줄에서 koreandict-mcp-server로 실행하거나, 로컬 프로젝트에 설치하여 코드에서 KoreanDictionaryMcpServer 인스턴스를 생성해 사용합니다. 실행 전에 국립국어원에서 발급받은 API 키를 .env 파일의 KOREANDICT_API_KEY 환경 변수 또는 mcp.json 설정 파일에 설정해야 합니다.

Key features of 국립국어원 표준국어대사전 MCP 서버

• MCP 리소스로 단어 검색 결과 제공 (koreandict://word/{word})
• 품사별 단어 검색 리소스 (koreandict://pos/{pos}/word/{word})
• search-word 도구로 단어 검색 (검색 방식, 결과 개수 지정 가능)
• search-by-pos 도구로 품사별 단어 검색
• 직접 실행 및 프로그래밍 방식 모두 지원
• MCP 클라이언트(Cursor 등)와 통합 가능

Use cases of 국립국어원 표준국어대사전 MCP 서버

• LLM이 한국어 단어의 정의, 예문, 품사 정보를 실시간 조회
• 품사를 기준으로 단어를 필터링하여 사전 검색
• 문서 작성 시 한국어 어휘 검증 및 참고
• 외국어 학습 도구에 한국어 사전 기능 통합
• MCP를 지원하는 IDE(Cursor)에서 코드 작성 중 사전 정보 활용

FAQ from 국립국어원 표준국어대사전 MCP 서버

어떤 API 키가 필요한가요?

국립국어원 표준국어대사전 오픈 API 사용을 위해 국립국어원에서 발급받은 API 키가 필요합니다.

서버를 어떻게 설치하나요?

NPM을 통해 전역 설치(npm install -g koreandict-mcp-server)하거나 로컬 프로젝트에 설치(npm install koreandict-mcp-server)할 수 있습니다.

API 키는 어떻게 설정하나요?

.env 파일에 KOREANDICT_API_KEY=your-api-key-here를 추가하거나, mcp.json 설정 파일의 env 객체에 KOREANDICT_API_KEY를 포함시킵니다.

어떤 MCP 도구와 리소스가 제공되나요?

리소스는 koreandict://word/{word}와 koreandict://pos/{pos}/word/{word}이며, 도구는 search-word와 search-by-pos입니다.

MCP 연결 오류가 발생하면 어떻게 하나요?

API 키가 올바르게 설정되었는지, mcp.json 파일의 경로가 올바른지 확인하고, 로그에 나타난 오류 메시지를 검토하세요.