Многоязычный словарь 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 запускается при каждом push и PR в ветку main на Node 20 и 22.

• Публикация запускается при создании GitHub Release — тесты, сборка, затем публикация как в npm (как multilingual-dictionary-mcp), так и в GitHub Packages (как @eyalm321/multilingual-dictionary-mcp).

Чтобы сделать релиз:

1. Увеличьте version в package.json и сделайте коммит.

2. Поставьте тег и сделайте push (например, git tag v0.1.1 && git push --tags).

3. Создайте GitHub Release, указывающий на этот тег — рабочий процесс публикации сделает все остальное.

Рабочий процесс публикации ожидает два секрета репозитория: NPM_TOKEN (токен автоматизации npm) и GITHUB_TOKEN (автоматически предоставляется GitHub Actions).

Лицензия

MIT © Eyalm321