dictcc-mcp 0.1.0__tar.gz

dictcc_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for PyPI trusted publishing (OIDC)
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

dictcc_mcp-0.1.0/.github/workflows/registry.yml

@@ -0,0 +1,61 @@
+name: Publish to MCP Registry
+
+# Official MCP Registry (registry.modelcontextprotocol.io) via GitHub OIDC.
+# No secret, no interactive login: the runner's OIDC token proves ownership
+# of the io.github.mohammad-abbasi-sh/* namespace.
+# Refs: https://github.com/modelcontextprotocol/registry
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for OIDC -> MCP Registry
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Sync server.json version to tag
+        # Only sync when running on a version tag (v*). On workflow_dispatch
+        # (ref = refs/heads/main) keep the version committed in server.json.
+        run: |
+          VER=""
+          if [[ "$GITHUB_REF" == refs/tags/* ]]; then
+            TAG="${GITHUB_REF#refs/tags/}"
+            VER="${TAG#v}"
+          fi
+          if [ -n "$VER" ]; then
+            python3 - "$VER" << 'EOF'
+          import json, sys
+          ver = sys.argv[1]
+          d = json.load(open('server.json'))
+          d['version'] = ver
+          for pkg in d.get('packages', []):
+              pkg['version'] = ver
+          json.dump(d, open('server.json', 'w'), indent=2, ensure_ascii=False)
+          print('server.json version ->', ver)
+          EOF
+          else
+            echo "No version tag ($GITHUB_REF); keeping server.json version as-is"
+          fi
+
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.7/mcp-publisher_linux_amd64.tar.gz" -o /tmp/mcp-publisher.tar.gz
+          tar -xzf /tmp/mcp-publisher.tar.gz -C /tmp
+          sudo mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher
+          mcp-publisher --version
+
+      - name: Validate server.json
+        run: mcp-publisher validate server.json
+
+      - name: Publish to MCP Registry (OIDC)
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish server.json
+        # A registry outage must never break the release; re-run from Actions if needed.
+        continue-on-error: true

dictcc_mcp-0.1.0/.github/workflows/smoke.yml

@@ -0,0 +1,21 @@
+name: Daily live smoke
+
+# One fixed probe per day: catches fingerprint rot / bot-wall changes
+# before users hit them. Fails visibly on 403/timeout.
+on:
+  schedule:
+    - cron: "0 6 * * *"
+  workflow_dispatch:
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e .
+      - name: Smoke probe
+        run: python tests/smoke_live.py

dictcc_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammad Abbasi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dictcc_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.5
+Name: dictcc-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for dict.cc — translations across 23 language pairs
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# dictcc-mcp 🌐
+
+mcp-name: io.github.mohammad-abbasi-sh/dictcc-mcp
+
+Unofficial **read-only** MCP server for **[dict.cc](https://www.dict.cc)** — dict.cc translations from dict.cc (free, no key, no login): German-English plus 22 more pairs, with word class, gender, usage notes and community votes. No key, no login.
+
+> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with dict.cc.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "dictcc": {
+      "command": "uvx",
+      "args": ["dictcc-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m dictcc_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `dictcc_translate` | Translate a word or phrase with dict.cc: translations with word class, gender, usage notes & community votes — `query`, `pair` (de-en default; de-el, de-eo, de-es, de-fi, de-fr, de-hr, de-hu, de-is, de-it, de-la, de-nl, de-no, de-pl, de-pt, de-ro, de-ru, de-sk, de-sq, de-sr, de-sv, de-tr, de-uk), `limit` 1..50 |
+| `dictcc_search` | Find dict.cc headwords matching a query (prefix/containment) — `query`, `pair` (de-en default), `limit` 1..50 |
+| `dictcc_health` | Reachability probe (ok / blocked / error) — one polite request |
+
+## Notes
+
+- All data comes from **dict.cc's public search pages** (free, no key, no login).
+- Translation rows carry the word, `<var>` word-class markers (`{adj}`, `{n}`, `{f}` …), `<kbd>` bracket notes and the community vote count; rows are returned in dict.cc's own vote ranking.
+- 23 language pairs share the same page structure (DE-EN on `www.dict.cc`, the rest on `<deXX>.dict.cc`); the query direction is auto-detected from which side matches first in dict.cc's ranking.
+- dict.cc has NO example sentences and NO verb conjugation on these pages (verified 2026-11-10) — only translations and headword search are exposed. For verb conjugation use `duden-mcp`.
+- A query with no matches returns 200 with zero rows (not an error).
+
+Tests: 23/23 green (18 offline + 5 live, 2026-11-10).
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## License
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

dictcc_mcp-0.1.0/README-de.md

@@ -0,0 +1,48 @@
+# dictcc-mcp 🌐
+
+mcp-name: io.github.mohammad-abbasi-sh/dictcc-mcp
+
+Inoffizieller **nur lesender** MCP-Server für **[dict.cc](https://www.dict.cc)** — dict.cc-Übersetzungen von dict.cc (kostenlos, kein Schlüssel, kein Login): Deutsch-Englisch plus 22 weitere Sprachenpaare, mit Wortart, Genus, Gebrauchshinweisen und Community-Stimmen. Kein Schlüssel, keine Anmeldung.
+
+> Gebaut von Mohammad Abbasi als Teil der "Germany MCP factory". Nicht mit dict.cc verbunden.
+
+## Für KI-Agenten
+
+Zur MCP-Client-Konfiguration hinzufügen (stdio):
+
+```json
+{
+  "mcpServers": {
+    "dictcc": {
+      "command": "uvx",
+      "args": ["dictcc-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Oder lokal starten: `python -m dictcc_mcp.server` (benötigt `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Beschreibung |
+|------|-------------|
+| `dictcc_translate` | Ein Wort mit dict.cc übersetzen (23 Sprachenpaare) |
+| `dictcc_search` | dict.cc-Stichwörter zu einer Suchanfrage finden |
+| `dictcc_health` | Erreichbarkeitsprüfung (ok / blocked / error) — eine höfliche Anfrage |
+
+## Entwicklung
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## Lizenz
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

dictcc_mcp-0.1.0/README-fa.md

@@ -0,0 +1,48 @@
+# dictcc-mcp 🌐
+
+mcp-name: io.github.mohammad-abbasi-sh/dictcc-mcp
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **[dict.cc](https://www.dict.cc)** — ترجمه‌های dict.cc از dict.cc (رایگان، بدون کلید): آلمانی–انگلیسی و ۲۲ زبان دیگر، با نوع کلمه، جنسیت، توضیحات کاربرد و آرای کاربران. بدون کلید، بدون ورود.
+
+> ساختهٔ محمد عباسی، بخشی از «کارخانهٔ MCP آلمان». وابسته به dict.cc نیست.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP کلاینت اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "dictcc": {
+      "command": "uvx",
+      "args": ["dictcc-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m dictcc_mcp.server` (نیازمند `mcp<2` و `httpx`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `dictcc_translate` | ترجمهٔ واژه با dict.cc (۲۳ زبان) |
+| `dictcc_search` | یافتن سرخط‌های dict.cc مطابق پرس‌وجو |
+| `dictcc_health` | بررسی دسترس‌پذیری (ok / blocked / error) — یک درخواست مؤدبانه |
+
+## توسعه
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## لایسنس
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

dictcc_mcp-0.1.0/README.md

@@ -0,0 +1,58 @@
+# dictcc-mcp 🌐
+
+mcp-name: io.github.mohammad-abbasi-sh/dictcc-mcp
+
+Unofficial **read-only** MCP server for **[dict.cc](https://www.dict.cc)** — dict.cc translations from dict.cc (free, no key, no login): German-English plus 22 more pairs, with word class, gender, usage notes and community votes. No key, no login.
+
+> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with dict.cc.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "dictcc": {
+      "command": "uvx",
+      "args": ["dictcc-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m dictcc_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `dictcc_translate` | Translate a word or phrase with dict.cc: translations with word class, gender, usage notes & community votes — `query`, `pair` (de-en default; de-el, de-eo, de-es, de-fi, de-fr, de-hr, de-hu, de-is, de-it, de-la, de-nl, de-no, de-pl, de-pt, de-ro, de-ru, de-sk, de-sq, de-sr, de-sv, de-tr, de-uk), `limit` 1..50 |
+| `dictcc_search` | Find dict.cc headwords matching a query (prefix/containment) — `query`, `pair` (de-en default), `limit` 1..50 |
+| `dictcc_health` | Reachability probe (ok / blocked / error) — one polite request |
+
+## Notes
+
+- All data comes from **dict.cc's public search pages** (free, no key, no login).
+- Translation rows carry the word, `<var>` word-class markers (`{adj}`, `{n}`, `{f}` …), `<kbd>` bracket notes and the community vote count; rows are returned in dict.cc's own vote ranking.
+- 23 language pairs share the same page structure (DE-EN on `www.dict.cc`, the rest on `<deXX>.dict.cc`); the query direction is auto-detected from which side matches first in dict.cc's ranking.
+- dict.cc has NO example sentences and NO verb conjugation on these pages (verified 2026-11-10) — only translations and headword search are exposed. For verb conjugation use `duden-mcp`.
+- A query with no matches returns 200 with zero rows (not an error).
+
+Tests: 23/23 green (18 offline + 5 live, 2026-11-10).
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## License
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

dictcc_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dictcc-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for dict.cc — translations across 23 language pairs"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "httpx>=0.27",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+dictcc-mcp = "dictcc_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dictcc_mcp"]
+
+[tool.pytest.ini_options]
+markers = ["live: tests that hit the real https://www.dict.cc site"]

dictcc_mcp-0.1.0/server.json

@@ -0,0 +1 @@
+{"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json", "description": "Unofficial read-only MCP server for dict.cc — translations in 23 language pairs.", "name": "io.github.mohammad-abbasi-sh/dictcc-mcp", "packages": [{"identifier": "dictcc-mcp", "registryBaseUrl": "https://pypi.org", "registryType": "pypi", "transport": {"type": "stdio"}, "version": "0.1.0"}], "repository": {"source": "github", "url": "https://github.com/mohammad-abbasi-sh/dictcc-mcp"}, "title": "dict.cc — German-English & 22 more pairs: translations with word class, gender & votes", "version": "0.1.0", "websiteUrl": "https://github.com/mohammad-abbasi-sh/dictcc-mcp"}

dictcc_mcp-0.1.0/src/dictcc_mcp/__init__.py

@@ -0,0 +1,7 @@
+"""dictcc_mcp — unofficial read-only MCP server for dict.cc.
+
+dict.cc translations from dict.cc (free, no key, no login): German-English plus 22 more pairs, with word class, gender, usage notes and community votes.
+"""
+from __future__ import annotations
+
+__version__ = "0.1.0"

dictcc_mcp-0.1.0/src/dictcc_mcp/domain.py

@@ -0,0 +1,186 @@
+"""Domain logic: shape dict.cc translation pages into compact dicts
+(stdlib only).
+
+Data source: dict.cc public search pages
+(https://www.dict.cc/?s=<word> for DE-EN,
+https://<pair>.dict.cc/?s=<word> for the other pairs) — free, no key,
+no login.
+
+Page structure (server-rendered HTML, verified 2026-11-10):
+- translation rows are <tr id='tr1'>…<tr id='trN'> with four <td>s:
+  [spacer][foreign side][German side][spacer]. The foreign cell
+  holds the word (first <a>), <var> word-class markers ({adj}, {n},
+  {f} …) and <kbd> bracket notes; the German cell additionally
+  carries a <div> with the community vote count. A no-match query
+  returns 200 with zero rows.
+- dict.cc has NO example sentences and NO verb conjugation on these
+  pages (verified: 'Beispiel' 0, no verb links, no audio URLs) — the
+  server exposes only what exists: translations + headword search.
+- Other pairs share the same structure (verified DE-FR 39 rows,
+  DE-ES 15, DE-IT 31, DE-TR/DE-RU 200).
+"""
+from __future__ import annotations
+
+import html as _html
+import re
+from urllib.parse import quote
+
+# pair code -> (subdomain, foreign language code). de-en lives on www.
+PAIRS = {
+    "de-en": ("www", "en"),
+    "de-el": ("deel", "el"),
+    "de-eo": ("deeo", "eo"),
+    "de-es": ("dees", "es"),
+    "de-fi": ("defi", "fi"),
+    "de-fr": ("defr", "fr"),
+    "de-hr": ("dehr", "hr"),
+    "de-hu": ("dehu", "hu"),
+    "de-is": ("deis", "is"),
+    "de-it": ("deit", "it"),
+    "de-la": ("dela", "la"),
+    "de-nl": ("denl", "nl"),
+    "de-no": ("deno", "no"),
+    "de-pl": ("depl", "pl"),
+    "de-pt": ("dept", "pt"),
+    "de-ro": ("dero", "ro"),
+    "de-ru": ("deru", "ru"),
+    "de-sk": ("desk", "sk"),
+    "de-sq": ("desq", "sq"),
+    "de-sr": ("desr", "sr"),
+    "de-sv": ("desv", "sv"),
+    "de-tr": ("detr", "tr"),
+    "de-uk": ("deuk", "uk"),
+}
+
+LANG_NAMES = {
+    "en": "English", "el": "Greek", "eo": "Esperanto", "es": "Spanish",
+    "fi": "Finnish", "fr": "French", "hr": "Croatian", "hu": "Hungarian",
+    "is": "Icelandic", "it": "Italian", "la": "Latin", "nl": "Dutch",
+    "no": "Norwegian", "pl": "Polish", "pt": "Portuguese",
+    "ro": "Romanian", "ru": "Russian", "sk": "Slovak", "sq": "Albanian",
+    "sr": "Serbian", "sv": "Swedish", "tr": "Turkish",
+    "uk": "Ukrainian",
+}
+
+_TAG_RE = re.compile(r"<[^>]+>")
+_WS_RE = re.compile(r"\s+")
+_ROW_RE = re.compile(r"<tr id='tr\d+'>(.*?)</tr>", re.S)
+_TD_RE = re.compile(r"<td[^>]*>(.*?)</td>", re.S)
+
+
+def validate_pair(pair: str) -> str:
+    p = (pair or "de-en").strip().lower()
+    if p not in PAIRS:
+        raise ValueError(
+            f"unsupported pair: {pair!r} "
+            f"(use one of: {', '.join(sorted(PAIRS))})")
+    return p
+
+
+def validate_query(query: str) -> str:
+    q = (query or "").strip()
+    if not q:
+        raise ValueError("query must not be empty")
+    if len(q) > 100:
+        raise ValueError("query too long (max 100 characters)")
+    return q
+
+
+def validate_limit(limit: int) -> int:
+    if not 1 <= limit <= 50:
+        raise ValueError(f"limit out of range: {limit} (expected 1..50)")
+    return limit
+
+
+def pair_url(pair: str, query: str) -> str:
+    sub, _lang = PAIRS[pair]
+    return f"https://{sub}.dict.cc/?s={quote(query)}"
+
+
+def _clean(text: str) -> str:
+    return _WS_RE.sub(" ", _html.unescape(_TAG_RE.sub(" ", text or ""))).strip()
+
+
+def _parse_cell(cell: str) -> dict:
+    """{word, info, votes} — word = first link text; info = <var>
+    markers + <kbd> bracket notes; votes = community vote count."""
+    m = re.search(r"<a[^>]*>(.*?)</a>", cell, re.S)
+    word = _clean(m.group(1)) if m else ""
+    # compound marker: <b>Haus</b>- / Akzept-<b>Haus</b> render with a
+    # space around the hyphen after tag stripping; rejoin it
+    word = re.sub(r"\s*-\s*", "-", word)
+    markers = [_clean(v) for v in re.findall(
+        r"<var[^>]*>([^<]*)</var>", cell)]
+    notes = [_clean(k) for k in re.findall(
+        r"<kbd[^>]*>([^<]*)</kbd>", cell)]
+    notes = [n for n in notes if n]
+    info_parts = [x for x in markers if x]
+    if notes:
+        info_parts.append(" ".join(notes))
+    vm = re.search(r"<div[^>]*>(\d+)</div>", cell)
+    return {"word": word,
+            "info": " ".join(info_parts),
+            "votes": int(vm.group(1)) if vm else 0}
+
+
+def parse_table(html: str, other_lang: str) -> list[dict]:
+    """[{german, german_info, <other_lang>, <other_lang>_info, votes}]
+    — row order (dict.cc's own ranking by votes)."""
+    out = []
+    for row in _ROW_RE.findall(html):
+        tds = _TD_RE.findall(row)
+        if len(tds) < 3:
+            continue
+        foreign = _parse_cell(tds[1])
+        german = _parse_cell(tds[2])
+        if not foreign["word"] and not german["word"]:
+            continue
+        out.append({
+            "german": german["word"],
+            "german_info": german["info"],
+            other_lang: foreign["word"],
+            f"{other_lang}_info": foreign["info"],
+            "votes": german["votes"] or foreign["votes"],
+        })
+    return out
+
+
+def detect_direction(items: list[dict], query: str, other_lang: str) -> str:
+    """Which side the query matched: 'de', the foreign code, or
+    'unknown'. Rows are dict.cc's own relevance ranking, so the
+    first row that matches decides; within a row, exact beats prefix
+    beats substring. (A plain all-German-first scan mislabels an
+    English query like 'house' because a German loanword 'House'
+    sits further down the list.)"""
+    q = query.casefold()
+    for it in items:
+        de, other = it["german"].casefold(), it[other_lang].casefold()
+        if de == q:
+            return "de"
+        if other == q:
+            return other_lang
+        if de.startswith(q):
+            return "de"
+        if other.startswith(q):
+            return other_lang
+        if q in de:
+            return "de"
+        if q in other:
+            return other_lang
+    return "unknown"
+
+
+def parse_search(html: str, other_lang: str, query: str) -> list[dict]:
+    """Distinct headwords containing the query, from both sides of
+    the result table, in row order: [{word, lang}]."""
+    q = query.casefold()
+    out: list[dict] = []
+    seen = set()
+    for it in parse_table(html, other_lang):
+        for word, lang in ((it["german"], "de"),
+                           (it[other_lang], other_lang)):
+            key = (word.casefold(), lang)
+            if word and q in word.casefold() and key not in seen:
+                seen.add(key)
+                out.append({"word": word, "lang": lang})
+    return out

dictcc_mcp-0.1.0/src/dictcc_mcp/http.py

@@ -0,0 +1,99 @@
+"""HTTP layer for dictcc_mcp — plain httpx GETs against dict.cc.
+
+No key, no login. One retry on 429/5xx; error taxonomy (403/429/other).
+"""
+from __future__ import annotations
+
+import os
+import ssl
+import time
+
+import httpx
+
+UA = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
+)
+TIMEOUT = 25.0
+PROBE_URL = "https://www.dict.cc/?s=Haus"
+SOURCE = "dict.cc"
+
+
+class DictccMcpError(RuntimeError):
+    pass
+
+
+def _verify():
+    """TLS trust store: the OS bundle when present, else httpx/certifi."""
+    for path in (
+        "/etc/ssl/certs/ca-certificates.crt",
+        ssl.get_default_verify_paths().openssl_cafile,
+    ):
+        if path and os.path.exists(path):
+            return ssl.create_default_context(cafile=path)
+    return True
+
+
+def _client() -> httpx.Client:
+    # NOTE: we read the proxy URL from the environment but never log it.
+    proxy = os.environ.get("https_proxy") or os.environ.get("HTTPS_PROXY")
+    return httpx.Client(
+        headers={"User-Agent": UA, "Accept": "application/json, application/xml, text/html, */*"},
+        timeout=TIMEOUT,
+        proxy=proxy or None,
+        trust_env=False,
+        verify=_verify(),
+    )
+
+
+def fetch_text(url: str) -> str:
+    """GET one URL and return its text. One retry on 429/5xx."""
+    last_exc: Exception | None = None
+    r: httpx.Response | None = None
+    for attempt in range(2):
+        try:
+            with _client() as c:
+                r = c.get(url)
+        except httpx.HTTPError as e:
+            last_exc = e
+            if attempt == 0:
+                time.sleep(1.0)
+                continue
+            raise DictccMcpError(f"network error fetching {url}: {e}") from e
+        if r.status_code in (429, 500, 502, 503):
+            if attempt == 0:
+                time.sleep(1.0)
+                continue
+        break
+    assert r is not None  # loop always assigns r or raises
+    if r.status_code == 403:
+        raise DictccMcpError(
+            f"{SOURCE} returned HTTP 403 for {url} (bot wall) — try again later"
+        )
+    if r.status_code == 429:
+        raise DictccMcpError(
+            f"{SOURCE} rate-limited the request (HTTP 429) — try again later"
+        )
+    if r.status_code != 200:
+        raise DictccMcpError(f"{SOURCE} returned HTTP {r.status_code} for {url}")
+    return r.text
+
+
+def health_check() -> dict:
+    """One polite probe of the source site.
+
+    Returns {"status": "ok"|"blocked"|"error", "http_status": int|None,
+    "url": ..., "detail": ...}. Used by the `<prefix>_health` tool
+    and the daily smoke CI.
+    """
+    url = PROBE_URL
+    try:
+        fetch_text(url)
+    except DictccMcpError as e:
+        msg = str(e)
+        if "403" in msg:
+            return {"status": "blocked", "http_status": 403, "url": url, "detail": msg}
+        if "429" in msg:
+            return {"status": "blocked", "http_status": 429, "url": url, "detail": msg}
+        return {"status": "error", "http_status": None, "url": url, "detail": msg}
+    return {"status": "ok", "http_status": 200, "url": url}