다국어 사전 MCP

다국어 사전 조회 및 단어 관계(유의어, 반의어, 상위어, 하위어, 부분어, 번역, 어원, 정의, 운율 등)를 위한 MCP 서버입니다. 세 가지 무료 공개 API를 결합하여 모든 언어를 지원합니다:

• ConceptNet — 다국어 의미 네트워크 (80개 이상의 언어, 단어 관계: 유의어, 반의어, IsA, PartOf, RelatedTo, DerivedFrom 등)

• Wiktionary — 4000개 이상의 언어에 대한 정의, 어원 및 발음

• Datamuse — 영어 전용 유틸리티 (운율, 유사 발음, "의미 유사", 철자 패턴, 문맥적 연관어)

API 키가 필요 없습니다. 번들된 데이터도 없습니다. Claude(또는 모든 MCP 클라이언트)에 연결하기만 하면 어떤 언어의 단어든 질문할 수 있습니다.

설치

npm 사용

npm install -g multilingual-dictionary-mcp

GitHub Packages 사용

npm install -g @eyalm321/multilingual-dictionary-mcp --registry=https://npm.pkg.github.com

Claude Desktop / Claude Code 설정

{
  "mcpServers": {
    "multilingual-dictionary": {
      "command": "npx",
      "args": ["-y", "multilingual-dictionary-mcp"]
    }
  }
}

도구

다국어 단어 관계 (ConceptNet)

이 모든 도구는 word(단어), ISO 639-1 language(언어) 코드(기본값: en), 그리고 limit(제한)을 인자로 받습니다. 영어, 스페인어, 프랑스어, 독일어, 이탈리아어, 러시아어, 히브리어, 아랍어, 라틴어, 중국어, 일본어 등 70개 이상의 언어에서 작동합니다.

정의 및 어원 (Wiktionary)

영어 전용 유틸리티 (Datamuse)

캐시 관리

캐싱

성공적인 모든 업스트림 응답은 전체 요청 URL을 키로 하여 서버 프로세스 수명 동안 메모리에 캐시됩니다. 동일한 세션 내에서 동일한 후속 호출은 ConceptNet/Wiktionary/Datamuse를 다시 호출하지 않고 즉시 반환됩니다.

• 기본 TTL: 24시간

• 기본 최대 항목 수: 5000개 (LRU 퇴거 방식)

• dictionary_random은 비활성화됨 (항상 달라져야 하므로)

• 디스크 지속성 없음 — 서버가 시작될 때마다 캐시가 다시 빌드됨

환경 변수를 통해 조정 가능:

MDM_DISABLE_CACHE=true        # turn caching off
MDM_CACHE_TTL_MS=3600000      # 1 hour TTL
MDM_CACHE_MAX_ENTRIES=10000   # bigger cache

예시

> What are the synonyms of "feliz" in Spanish?
[uses dictionary_synonyms with language: "es"]

> Translate "happiness" into Hebrew
[uses dictionary_translate with language: "en", targetLanguage: "he"]

> What's the etymology of the word "serendipity"?
[uses dictionary_etymology]

> Find me words that rhyme with "orange"
[uses dictionary_rhymes]

> What are the parts of a bicycle?
[uses dictionary_meronyms with word: "bicycle"]

개발

npm install
npm run build      # TypeScript compile
npm test           # vitest run
npm run test:watch # vitest watch
npm run dev        # ts-node entry point

프로젝트 레이아웃

src/
├── index.ts            # MCP server entry
├── client.ts           # HTTP wrappers for ConceptNet / Wiktionary / Datamuse
├── tools/
│   ├── relations.ts    # ConceptNet-backed multilingual relation tools
│   ├── definitions.ts  # Wiktionary-backed definition/etymology tools
│   └── english.ts      # Datamuse-backed English utilities
└── __tests__/          # vitest specs

CI / 릴리스

• CI는 Node 20 및 22 환경에서 main 브랜치에 대한 모든 푸시 및 PR 시 실행됩니다.

• 배포는 GitHub 릴리스가 게시될 때 실행됩니다. 테스트 및 빌드 후 npm(multilingual-dictionary-mcp로)과 GitHub Packages(@eyalm321/multilingual-dictionary-mcp로) 모두에 게시됩니다.

릴리스를 생성하려면:

1. package.json의 version을 올리고 커밋합니다.

2. 태그를 지정하고 푸시합니다 (예: git tag v0.1.1 && git push --tags).

3. 해당 태그를 가리키는 GitHub 릴리스를 생성하면 배포 워크플로우가 나머지를 처리합니다.

배포 워크플로우는 두 가지 저장소 비밀을 기대합니다: NPM_TOKEN(npm 자동화 토큰) 및 GITHUB_TOKEN(GitHub Actions에서 자동 제공).

라이선스

MIT © Eyalm321