Metadata-Version: 2.4
Name: dictionary-mcp-server
Version: 0.1.0
Summary: MCP-Server fuer Woerterbuch-Daten: Definitionen, Synonyme, Antonyme, Reime, Phonetik. Free Dictionary API + Datamuse, kein API-Key noetig.
Project-URL: Homepage, https://github.com/AiAgentKarl/dictionary-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/dictionary-mcp-server
Project-URL: Issues, https://github.com/AiAgentKarl/dictionary-mcp-server/issues
Author-email: AiAgentKarl <coach1916@gmail.com>
License: MIT
Keywords: ai-agent,antonyms,dictionary,linguistics,mcp,nlp,rhymes,synonyms,thesaurus,wordnet
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# dictionary-mcp-server

MCP-Server fuer AI-Agents mit Zugriff auf Woerterbuch-, Thesaurus- und Linguistik-Daten. Liefert Definitionen, Synonyme, Antonyme, Reime, Phonetik (IPA + Audio), Etymologie und semantische Assoziationen.

**Kein API-Key noetig** — kombiniert die [Free Dictionary API](https://dictionaryapi.dev/) und die [Datamuse API](https://www.datamuse.com/api/).

## 15 Tools

### Definitionen & Phonetik
- `tool_get_definition(word)` — Vollstaendige Definition(en) mit allen Wortarten
- `tool_get_phonetic(word)` — IPA-Transkription + Audio-URLs
- `tool_get_examples(word)` — Beispielsaetze, gruppiert nach Wortart
- `tool_get_word_origin(word)` — Etymologie und Ursprung wenn verfuegbar

### Thesaurus & Semantik
- `tool_get_synonyms(word, max_results=20)` — Aehnlich bedeutende Woerter
- `tool_get_antonyms(word, max_results=20)` — Gegenteilige Woerter
- `tool_get_word_associations(word, max_results=20)` — Semantisch verwandte Woerter (means-like)
- `tool_get_triggers(word, max_results=20)` — Statistisch oft im Kontext erscheinende Woerter
- `tool_get_hypernyms(word, max_results=20)` — Oberbegriffe (oak -> tree)
- `tool_get_hyponyms(word, max_results=20)` — Unterbegriffe (tree -> oak, maple)

### Reime & Phonetische Suche
- `tool_get_rhymes(word, max_results=20, perfect_only=True)` — Perfekte oder near-rhymes
- `tool_get_sounds_like(word, max_results=20)` — Phonetisch aehnliche Woerter
- `tool_spell_check(pattern, max_results=20)` — Pattern-Matching mit `?`/`*` Wildcards

### All-in-One
- `tool_word_full_report(word)` — Definition + Phonetik + Synonyme + Antonyme + Reime in einem Call
- `tool_get_server_info()` — Server-Metadaten

## Installation

```bash
pip install dictionary-mcp-server
```

## Konfiguration (Claude Desktop)

```json
{
  "mcpServers": {
    "dictionary": {
      "command": "dictionary-mcp-server"
    }
  }
}
```

## Beispiele

```python
# Vollstaendige Definition + Beispiele
await tool_get_definition("serendipity")

# Synonyme fuer Brainstorming
await tool_get_synonyms("happy", max_results=10)

# Reime fuer Songtexte / Poesie
await tool_get_rhymes("love", perfect_only=True)

# Spell-Check via Pattern
await tool_spell_check("hel?o")  # findet hello, helio

# Alles auf einen Schlag
await tool_word_full_report("computer")
```

## Datenquellen

- **Free Dictionary API** (dictionaryapi.dev) — Definitionen, IPA, Beispiele, Audio. Kein API-Key, unbegrenzt.
- **Datamuse API** (datamuse.com/api) — Thesaurus, Reime, Assoziationen. Kein API-Key, 100k Calls/Tag frei.

## Lizenz

MIT
