tdk-api-wrapper 1.6.1 → 1.7.1

package/dist/index.js

@@ -37,13 +37,15 @@ __export(src_exports, {
   TDKValidationError: () => TDKValidationError,
   TURKISH_SUFFIXES: () => TURKISH_SUFFIXES,
   TURKISH_VOWELS: () => TURKISH_VOWELS,
+  createMcpServer: () => createMcpServer,
   getStemCandidates: () => getStemCandidates,
   isVowel: () => isVowel,
   restoreConsonantSoftening: () => restoreConsonantSoftening,
   restoreGemination: () => restoreGemination,
   restoreInfinitive: () => restoreInfinitive,
   restoreVowelDrop: () => restoreVowelDrop,
-  restoreVowelNarrowing: () => restoreVowelNarrowing
+  restoreVowelNarrowing: () => restoreVowelNarrowing,
+  runMcpServer: () => runMcpServer
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -74,11 +76,7 @@ var TDKNetworkError = class extends TDKError {
   }
 };
 
-// src/morphology.ts
-var TURKISH_VOWELS = "ae\u0131io\xF6u\xFC";
-function isVowel(ch) {
-  return TURKISH_VOWELS.includes(ch);
-}
+// src/data/suffixes.ts
 var TURKISH_SUFFIXES = [
   // 9-letter composite suffixes
   "lerimizden",
@@ -481,6 +479,12 @@ var TURKISH_SUFFIXES = [
   "u",
   "\xFC"
 ];
+
+// src/morphology.ts
+var TURKISH_VOWELS = "ae\u0131io\xF6u\xFC";
+function isVowel(ch) {
+  return TURKISH_VOWELS.includes(ch);
+}
 function restoreConsonantSoftening(stem) {
   if (stem.length < 2)
     return [];
@@ -634,12 +638,7 @@ function getStemCandidates(word, minStemLength = 2, maxDepth = 4) {
   return [...new Set(candidatesWithWeight.map((c) => c.candidate))];
 }
 
-// src/tdk.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var os = __toESM(require("os"));
-var https = __toESM(require("https"));
-var tls = __toESM(require("tls"));
+// src/data/misspellings.ts
 var COMMON_MISSPELLINGS = {
   // -şey ile biten ve ayrı yazılması zorunlu söz öbekleri
   her\u015Fey: "her \u015Fey",
@@ -793,75 +792,10 @@ var COMMON_MISSPELLINGS = {
   babaanne: "babaanne"
 };
 var SEY_EXCEPTIONS = /* @__PURE__ */ new Set(["d\xFC\u015Fey", "e\u015Fey", "konsey", "jersey", "\u015Fey"]);
-var KEYBOARD_ROWS = [
-  ["qwertyu\u0131op\u011F\xFC", 0],
-  ["asdfghjkl\u015Fi", 0.5],
-  ["zxcvbnm\xF6\xE7", 1]
-];
-var KEYBOARD_COORDS = (() => {
-  const coords = {};
-  KEYBOARD_ROWS.forEach(([keys, offset], row) => {
-    [...keys].forEach((key, col) => {
-      coords[key] = [col + offset, row];
-    });
-  });
-  return coords;
-})();
-var DIACRITIC_SIBLINGS = {
-  \u0131: "i",
-  i: "\u0131",
-  \u00F6: "o",
-  o: "\xF6",
-  \u00FC: "u",
-  u: "\xFC",
-  \u015F: "s",
-  s: "\u015F",
-  \u00E7: "c",
-  c: "\xE7",
-  \u011F: "g",
-  g: "\u011F",
-  \u00E2: "a",
-  a: "\xE2"
-};
-var KEYBOARD_ROW_SUB_COST = 0.4;
-var KEYBOARD_DIAGONAL_SUB_COST = 0.55;
-var DIACRITIC_SUB_COST = 0.3;
-var TRANSPOSITION_COST = 0.8;
-function keyboardSubCost(a, b) {
-  if (a === b)
-    return 0;
-  if (DIACRITIC_SIBLINGS[a] === b)
-    return DIACRITIC_SUB_COST;
-  const pa = KEYBOARD_COORDS[a];
-  const pb = KEYBOARD_COORDS[b];
-  if (!pa || !pb)
-    return 1;
-  const dx = Math.abs(pa[0] - pb[0]);
-  const dy = Math.abs(pa[1] - pb[1]);
-  if (dy === 0 && dx <= 1 + 1e-9)
-    return KEYBOARD_ROW_SUB_COST;
-  if (dy === 1 && dx <= 1 + 1e-9)
-    return KEYBOARD_DIAGONAL_SUB_COST;
-  return 1;
-}
-var TDK = class {
-  static BASE_URL = "https://sozluk.gov.tr";
-  static AUDIO_API_HOST = "api.sozluk.gov.tr";
-  static KUBBEALTI_HOST = "eski.lugatim.com";
-  /**
-   * `eski.lugatim.com` (Kubbealtı Lugatı's data API) sends only its leaf
-   * certificate during the TLS handshake, omitting the intermediates a
-   * correctly configured server would include — a server-side misconfiguration,
-   * not something we should paper over by disabling verification. These are
-   * the two certificates the server *should* be sending (fetched from the
-   * leaf's own Authority Information Access URLs), supplied here so Node can
-   * still build a full, properly verified chain up to a root it already
-   * trusts (ISRG Root X1). If Let's Encrypt rotates this intermediate, this
-   * stops working and every Kubbealtı call fails closed to `null` — same
-   * fail-closed contract as the rest of this file's fragile integrations.
-   */
-  static KUBBEALTI_EXTRA_CA = [
-    `-----BEGIN CERTIFICATE-----
+
+// src/data/kubbealti-ca.ts
+var KUBBEALTI_EXTRA_CA = [
+  `-----BEGIN CERTIFICATE-----
 MIIE2jCCAsKgAwIBAgIQTr0klH4k05SALYSlL9WzGTANBgkqhkiG9w0BAQsFADAu
 MQswCQYDVQQGEwJVUzENMAsGA1UEChMESVNSRzEQMA4GA1UEAxMHUm9vdCBZUjAe
 Fw0yNTA5MDMwMDAwMDBaFw0yODA5MDIyMzU5NTlaMDMxCzAJBgNVBAYTAlVTMRYw
@@ -889,7 +823,7 @@ NA3wJdl4DDUuQSV8hBgx6zoI1ZSGORprDFux7c6rhc77QZMSRrEgomBeklervEve
 86ylWmZ3WWHV6RLMi8xNvjd71r4EPIGgY7BZU/VPBkq+uA7Gb6mbJnFgV43uh3xy
 LRFgxIAphIukwTGSMZZR+AI+Qnp0BYTWovHXozOf3H8r6hozEoT02JHn0AeTfA==
 -----END CERTIFICATE-----`,
-    `-----BEGIN CERTIFICATE-----
+  `-----BEGIN CERTIFICATE-----
 MIIF9DCCA9ygAwIBAgIRAPJLbRf52a18scn+p4eCaZ8wDQYJKoZIhvcNAQELBQAw
 TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
 cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMjYwNTEzMDAwMDAw
@@ -923,7 +857,112 @@ RGMuHGnzS3hFIrRTfKxrzUZ9RzQWzEG3K6fJ3r2nqSltkeytis9DIBoFY9VmVyjL
 M71DMi+y1+TRSJVClEMwvA4yL++7q9XZx5r5wBRWB4kQTKH5qyoZnDw7iiuh1lID
 yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
 -----END CERTIFICATE-----`
-  ];
+];
+
+// src/data/keyboard-layout.ts
+var KEYBOARD_ROWS = [
+  ["qwertyu\u0131op\u011F\xFC", 0],
+  ["asdfghjkl\u015Fi", 0.5],
+  ["zxcvbnm\xF6\xE7", 1]
+];
+var KEYBOARD_COORDS = (() => {
+  const coords = {};
+  KEYBOARD_ROWS.forEach(([keys, offset], row) => {
+    [...keys].forEach((key, col) => {
+      coords[key] = [col + offset, row];
+    });
+  });
+  return coords;
+})();
+var DIACRITIC_SIBLINGS = {
+  \u0131: "i",
+  i: "\u0131",
+  \u00F6: "o",
+  o: "\xF6",
+  \u00FC: "u",
+  u: "\xFC",
+  \u015F: "s",
+  s: "\u015F",
+  \u00E7: "c",
+  c: "\xE7",
+  \u011F: "g",
+  g: "\u011F",
+  \u00E2: "a",
+  a: "\xE2"
+};
+var KEYBOARD_ROW_SUB_COST = 0.4;
+var KEYBOARD_DIAGONAL_SUB_COST = 0.55;
+var DIACRITIC_SUB_COST = 0.3;
+var TRANSPOSITION_COST = 0.8;
+function keyboardSubCost(a, b) {
+  if (a === b)
+    return 0;
+  if (DIACRITIC_SIBLINGS[a] === b)
+    return DIACRITIC_SUB_COST;
+  const pa = KEYBOARD_COORDS[a];
+  const pb = KEYBOARD_COORDS[b];
+  if (!pa || !pb)
+    return 1;
+  const dx = Math.abs(pa[0] - pb[0]);
+  const dy = Math.abs(pa[1] - pb[1]);
+  if (dy === 0 && dx <= 1 + 1e-9)
+    return KEYBOARD_ROW_SUB_COST;
+  if (dy === 1 && dx <= 1 + 1e-9)
+    return KEYBOARD_DIAGONAL_SUB_COST;
+  return 1;
+}
+
+// src/lib/edit-distance.ts
+function damerauLevenshtein(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++)
+    dp[i][0] = i;
+  for (let j = 0; j <= b.length; j++)
+    dp[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+        dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + cost);
+      }
+    }
+  }
+  return dp[a.length][b.length];
+}
+function keyboardAwareDistance(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++)
+    dp[i][0] = i;
+  for (let j = 0; j <= b.length; j++)
+    dp[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      const cost = keyboardSubCost(a[i - 1], b[j - 1]);
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+        dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + TRANSPOSITION_COST);
+      }
+    }
+  }
+  return dp[a.length][b.length];
+}
+
+// src/lib/html.ts
+function htmlToPlainText(html) {
+  return html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|div)>/gi, "\n\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/gi, " ").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;|&rsquo;/gi, "'").replace(/&amp;/gi, "&").replace(/[ \t]+/g, " ").replace(/[ \t]*\n[ \t]*/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+
+// src/tdk.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var os = __toESM(require("os"));
+var https = __toESM(require("https"));
+var tls = __toESM(require("tls"));
+var TDK = class {
+  static BASE_URL = "https://sozluk.gov.tr";
+  static AUDIO_API_HOST = "api.sozluk.gov.tr";
+  static KUBBEALTI_HOST = "eski.lugatim.com";
   // Configuration
   static defaultTimeoutMs = 8e3;
   static defaultRetries = 1;
@@ -1470,12 +1509,12 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
         continue;
       if (Math.abs(candidate.length - cleanWord.length) > 2)
         continue;
-      const rawDist = this.damerauLevenshtein(cleanWord, candidate);
+      const rawDist = damerauLevenshtein(cleanWord, candidate);
       if (rawDist === 0 || rawDist > 2)
         continue;
       const firstMismatch = candidate[0] === cleanWord[0] ? 0 : 1;
       const lengthMismatch = candidate.length === cleanWord.length ? 0 : 1;
-      const score = this.keyboardAwareDistance(cleanWord, candidate) + (firstMismatch > 0 ? 1.2 : 0);
+      const score = keyboardAwareDistance(cleanWord, candidate) + (firstMismatch > 0 ? 1.2 : 0);
       const better = !best || score < best.score - 1e-9 || Math.abs(score - best.score) < 1e-9 && firstMismatch < best.firstMismatch || Math.abs(score - best.score) < 1e-9 && firstMismatch === best.firstMismatch && lengthMismatch < best.lengthMismatch;
       if (better) {
         best = { candidate, score, rawDist, firstMismatch, lengthMismatch };
@@ -1606,14 +1645,11 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
       const contentEnd = html.indexOf("<footer", contentStart);
       if (contentEnd === -1)
         return null;
-      return this.htmlToPlainText(html.slice(contentStart, contentEnd));
+      return htmlToPlainText(html.slice(contentStart, contentEnd));
     } catch {
       return null;
     }
   }
-  static htmlToPlainText(html) {
-    return html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|div)>/gi, "\n\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/gi, " ").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;|&rsquo;/gi, "'").replace(/&amp;/gi, "&").replace(/[ \t]+/g, " ").replace(/[ \t]*\n[ \t]*/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
-  }
   /**
    * GETs a JSON path from Kubbealtı Lugatı's data API (`eski.lugatim.com`),
    * supplying `KUBBEALTI_EXTRA_CA` to work around that host's incomplete
@@ -1627,7 +1663,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
           hostname: this.KUBBEALTI_HOST,
           path: path2,
           method: "GET",
-          ca: [...tls.rootCertificates, ...this.KUBBEALTI_EXTRA_CA],
+          ca: [...tls.rootCertificates, ...KUBBEALTI_EXTRA_CA],
           headers: {
             "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
           }
@@ -1719,7 +1755,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
     const entries = await this.getKubbealti(word);
     if (!entries)
       return null;
-    return entries.map((e) => this.htmlToPlainText(e.anlam));
+    return entries.map((e) => htmlToPlainText(e.anlam));
   }
   /**
    * Autocomplete suggestions from Kubbealtı Lugatı's own typeahead endpoint
@@ -1755,7 +1791,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
       const match = html.match(/<meta name="description" content="([^"]*)"/);
       if (!match)
         return null;
-      const description = this.htmlToPlainText(match[1]);
+      const description = htmlToPlainText(match[1]);
       if (description === "\xC7a\u011Fda\u015F T\xFCrk\xE7enin Etimolojisi")
         return null;
       return description;
@@ -1986,56 +2022,6 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
     }
     return analyses;
   }
-  /**
-   * Damerau-Levenshtein edit-distance (optimal string alignment variant):
-   * like classic Levenshtein but also counts an adjacent-character
-   * transposition (e.g. "yanlız" -> "yalnız") as a single edit instead of
-   * two substitutions — a very common class of typo that plain Levenshtein
-   * otherwise misses.
-   */
-  static damerauLevenshtein(a, b) {
-    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
-    for (let i = 0; i <= a.length; i++)
-      dp[i][0] = i;
-    for (let j = 0; j <= b.length; j++)
-      dp[0][j] = j;
-    for (let i = 1; i <= a.length; i++) {
-      for (let j = 1; j <= b.length; j++) {
-        const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-        dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
-        if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-          dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + cost);
-        }
-      }
-    }
-    return dp[a.length][b.length];
-  }
-  /**
-   * Keyboard- and diacritic-aware edit distance: same optimal-string-alignment
-   * recurrence as {@link damerauLevenshtein}, but a substitution is charged by
-   * {@link keyboardSubCost} (a fraction of an edit when the two letters are
-   * adjacent on a Turkish Q keyboard or are ASCII/diacritic siblings) and a
-   * transposition costs {@link TRANSPOSITION_COST}. Insertions and deletions
-   * still cost a full 1. Used only to *rank* spelling candidates; the plain
-   * integer distance still gates whether a suggestion is offered at all.
-   */
-  static keyboardAwareDistance(a, b) {
-    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
-    for (let i = 0; i <= a.length; i++)
-      dp[i][0] = i;
-    for (let j = 0; j <= b.length; j++)
-      dp[0][j] = j;
-    for (let i = 1; i <= a.length; i++) {
-      for (let j = 1; j <= b.length; j++) {
-        const cost = keyboardSubCost(a[i - 1], b[j - 1]);
-        dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
-        if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-          dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + TRANSPOSITION_COST);
-        }
-      }
-    }
-    return dp[a.length][b.length];
-  }
   /**
    * Fetches multiple words concurrently with a small delay to avoid rate limiting.
    */
@@ -2504,6 +2490,277 @@ var TDKClient = class {
     return TDK.checkLabialHarmony(word);
   }
 };
+
+// src/mcp.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+var import_zod = require("zod");
+var VERSION = "1.7.0";
+function ok(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function fail(message) {
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: message }, null, 2) }],
+    isError: true
+  };
+}
+function guard(fn) {
+  return async (args) => {
+    try {
+      return await fn(args);
+    } catch (error) {
+      return fail(error instanceof Error ? error.message : String(error));
+    }
+  };
+}
+function createMcpServer() {
+  const server = new import_mcp.McpServer({
+    name: "TDK API Server",
+    version: VERSION
+  });
+  server.tool(
+    "tdk_lookup",
+    "Bir kelimenin TDK G\xFCncel T\xFCrk\xE7e S\xF6zl\xFCk'teki ham kayd\u0131n\u0131 (t\xFCm anlamlar, \xF6rnekler, birle\u015Fikler, k\xF6ken, atas\xF6zleri) d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime (\xF6rn: 'kalem').") },
+    guard(async ({ word }) => {
+      const results = await TDK.getWord(word);
+      if (results.length === 0)
+        return fail(`"${word}" TDK s\xF6zl\xFC\u011F\xFCnde bulunamad\u0131.`);
+      return ok(results);
+    })
+  );
+  server.tool(
+    "tdk_meanings",
+    "Bir kelimenin sadele\u015Ftirilmi\u015F anlam listesini (madde madde tan\u0131mlar) d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, meanings: await TDK.getMeanings(word) }))
+  );
+  server.tool(
+    "tdk_examples",
+    "Bir kelimenin s\xF6zl\xFCkteki \xF6rnek c\xFCmlelerini (varsa yazar\u0131yla) d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, examples: await TDK.getExamples(word) }))
+  );
+  server.tool(
+    "tdk_proverbs",
+    "Bir kelime ile kurulan atas\xF6z\xFC ve deyimleri listeler.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime (\xF6rn: 'g\xF6z').") },
+    guard(async ({ word }) => ok({ word, proverbs: await TDK.getProverbs(word) }))
+  );
+  server.tool(
+    "tdk_compound_words",
+    "Bir kelime ile olu\u015Fturulmu\u015F birle\u015Fik kelimeleri listeler (\xF6rn: 'kalem' -> 'dolma kalem').",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, compounds: await TDK.getCompoundWords(word) }))
+  );
+  server.tool(
+    "tdk_part_of_speech",
+    "Bir kelimenin s\xF6zc\xFCk t\xFCrlerini (isim, s\u0131fat, zarf, fiil vb.) d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, partsOfSpeech: await TDK.getPartOfSpeech(word) }))
+  );
+  server.tool(
+    "tdk_synonyms",
+    "Bir kelimenin e\u015F anlaml\u0131lar\u0131n\u0131 (yak\u0131n anlaml\u0131 kelimeler) d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, synonyms: await TDK.getSynonyms(word) }))
+  );
+  server.tool(
+    "tdk_antonyms",
+    "Bir kelimenin z\u0131t (kar\u015F\u0131t) anlaml\u0131lar\u0131n\u0131 d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => ok({ word, antonyms: await TDK.getAntonyms(word) }))
+  );
+  server.tool(
+    "tdk_origin",
+    "Bir kelimenin TDK'deki k\xF6ken bilgisini ve yabanc\u0131 k\xF6kenli olup olmad\u0131\u011F\u0131n\u0131 d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Aranacak T\xFCrk\xE7e kelime.") },
+    guard(async ({ word }) => {
+      const [origin, foreign] = await Promise.all([TDK.getOrigin(word), TDK.isForeignWord(word)]);
+      return ok({ word, origin, isForeign: foreign });
+    })
+  );
+  server.tool(
+    "tdk_nisanyan",
+    "Ni\u015Fanyan S\xF6zl\xFCk'ten bir kelimenin ayr\u0131nt\u0131l\u0131 etimolojisini (server-rendered meta a\xE7\u0131klamas\u0131) \xE7eker.",
+    { word: import_zod.z.string().describe("Etimolojisi aranacak kelime.") },
+    guard(async ({ word }) => {
+      const etymology = await TDK.getNisanyan(word);
+      return etymology ? ok({ word, etymology }) : fail(`Ni\u015Fanyan S\xF6zl\xFCk'te "${word}" bulunamad\u0131.`);
+    })
+  );
+  server.tool(
+    "tdk_kubbealti",
+    "Kubbealt\u0131 Lugat\u0131'ndan (ticari s\xF6zl\xFCk) bir kelimenin anlamlar\u0131n\u0131 \xE7eker.",
+    { word: import_zod.z.string().describe("Aranacak kelime.") },
+    guard(async ({ word }) => {
+      const meanings = await TDK.getKubbealtiMeanings(word);
+      if (meanings === null)
+        return fail("Kubbealt\u0131 Lugat\u0131'na ula\u015F\u0131lamad\u0131.");
+      return ok({ word, meanings });
+    })
+  );
+  server.tool(
+    "tdk_wiktionary",
+    "T\xFCrk\xE7e Wiktionary'den (tr.wiktionary.org, resmi MediaWiki API) bir maddenin b\xF6l\xFCmlere ayr\u0131lm\u0131\u015F i\xE7eri\u011Fini \xE7eker.",
+    {
+      word: import_zod.z.string().describe("Aranacak madde ba\u015Fl\u0131\u011F\u0131."),
+      section: import_zod.z.string().optional().describe("Sadece belirli bir b\xF6l\xFCm istenirse ba\u015Fl\u0131k ad\u0131 (\xF6rn: 'K\xF6ken', '\xC7eviriler').")
+    },
+    guard(async ({ word, section }) => {
+      if (section) {
+        const text = await TDK.getWiktionarySection(word, section);
+        return text ? ok({ word, section, text }) : fail(`Wiktionary'de "${word}" i\xE7in "${section}" b\xF6l\xFCm\xFC bulunamad\u0131.`);
+      }
+      const entry = await TDK.getWiktionary(word);
+      return entry ? ok(entry) : fail(`Wiktionary'de "${word}" bulunamad\u0131.`);
+    })
+  );
+  server.tool(
+    "tdk_spell_check",
+    "Bir kelimenin do\u011Fru yaz\u0131l\u0131p yaz\u0131lmad\u0131\u011F\u0131n\u0131 denetler; yanl\u0131\u015Fsa klavye/diakritik fark\u0131ndal\u0131kl\u0131 en yak\u0131n madde \xF6nerisi verir, \xE7ekimli bi\xE7imse k\xF6k\xFCn\xFC d\xF6nd\xFCr\xFCr.",
+    { word: import_zod.z.string().describe("Yaz\u0131m\u0131 denetlenecek kelime (\xF6rn: 'yanl\u0131z', 'arabs').") },
+    guard(async ({ word }) => ok(await TDK.checkSpelling(word)))
+  );
+  server.tool(
+    "tdk_proofread",
+    "Bir T\xFCrk\xE7e metni imla, ayr\u0131/biti\u015Fik yaz\u0131m ve 'da/de', 'ki', 'mi' ba\u011Fla\xE7/ek hatalar\u0131 a\xE7\u0131s\u0131ndan denetler.",
+    { text: import_zod.z.string().describe("Denetlenecek T\xFCrk\xE7e metin.") },
+    guard(async ({ text }) => ok(await TDK.proofread(text)))
+  );
+  server.tool(
+    "tdk_stem",
+    "Bir kelimenin morfolojik k\xF6k\xFCn\xFC (ek s\u0131y\u0131rma / stemming) bulur ve \xE7ekimli olup olmad\u0131\u011F\u0131n\u0131 belirtir (\xF6rn: 'kitab\u0131m\u0131z\u0131n' -> 'kitap').",
+    { word: import_zod.z.string().describe("K\xF6k\xFC aranacak kelime.") },
+    guard(async ({ word }) => {
+      const result = await TDK.stem(word);
+      return result ? ok(result) : fail(`"${word}" i\xE7in k\xF6k tespit edilemedi.`);
+    })
+  );
+  server.tool(
+    "tdk_analyze_text",
+    "Bir metindeki her kelime i\xE7in k\xF6k, anlam ve k\xF6ken bilgisini toplu olarak \xE7\u0131kar\u0131r.",
+    { text: import_zod.z.string().describe("Analiz edilecek T\xFCrk\xE7e metin.") },
+    guard(async ({ text }) => ok(await TDK.analyzeText(text)))
+  );
+  server.tool(
+    "tdk_syllables",
+    "Bir kelimeyi T\xFCrk\xE7e hece kurallar\u0131na g\xF6re hecelere ay\u0131r\u0131r (tamamen yerel, a\u011F iste\u011Fi yok).",
+    { word: import_zod.z.string().describe("Hecelenecek kelime.") },
+    guard(async ({ word }) => ok({ word, syllables: TDK.syllabicate(word) }))
+  );
+  server.tool(
+    "tdk_vowel_harmony",
+    "Bir kelimenin b\xFCy\xFCk \xFCnl\xFC uyumuna ve k\xFC\xE7\xFCk \xFCnl\xFC uyumuna (d\xFCzl\xFCk-yuvarlakl\u0131k) uyup uymad\u0131\u011F\u0131n\u0131 kontrol eder.",
+    { word: import_zod.z.string().describe("Kontrol edilecek kelime.") },
+    guard(
+      async ({ word }) => ok({
+        word,
+        vowelHarmony: TDK.checkVowelHarmony(word),
+        labialHarmony: TDK.checkLabialHarmony(word)
+      })
+    )
+  );
+  server.tool(
+    "tdk_autocomplete",
+    "Bir \xF6nek ile ba\u015Flayan s\xF6zl\xFCk maddelerini (autocomplete) d\xF6nd\xFCr\xFCr.",
+    { prefix: import_zod.z.string().describe("Aranacak \xF6nek (\xF6rn: 'kalem').") },
+    guard(async ({ prefix }) => ok({ prefix, suggestions: await TDK.getSuggestions(prefix) }))
+  );
+  server.tool(
+    "tdk_pattern_search",
+    "Bulmaca deseni ile e\u015Fle\u015Fen s\xF6zl\xFCk maddelerini bulur: '_' veya '?' tek harf, '*' s\u0131f\u0131r ya da daha fazla harf yerine ge\xE7er (\xF6rn: 'k_l_m').",
+    {
+      pattern: import_zod.z.string().describe("Desen. '_'/'?' = tek harf, '*' = s\u0131f\u0131r ya da daha fazla harf."),
+      max_results: import_zod.z.number().int().min(1).max(500).default(50).describe("En fazla sonu\xE7 say\u0131s\u0131.")
+    },
+    guard(async ({ pattern, max_results }) => {
+      const matches = await TDK.patternSearch(pattern, { maxResults: max_results });
+      return ok({ pattern, count: matches.length, matches });
+    })
+  );
+  server.tool(
+    "tdk_anagram",
+    "Verilen harflerle kurulabilecek T\xFCrk\xE7e s\xF6zl\xFCk maddelerini bulur. Birebir anagram varsa onlar, yoksa harflerin bir alt k\xFCmesiyle kurulan kelimeler d\xF6ner.",
+    {
+      letters: import_zod.z.string().describe("Kullan\u0131lacak harfler (\xF6rn: 'kalem')."),
+      exact_length: import_zod.z.boolean().default(false).describe("Sadece harflerin tamam\u0131n\u0131 kullanan birebir anagramlar\u0131 d\xF6nd\xFCr."),
+      max_results: import_zod.z.number().int().min(1).max(500).default(50).describe("En fazla sonu\xE7 say\u0131s\u0131.")
+    },
+    guard(async ({ letters, exact_length, max_results }) => {
+      const words = await TDK.findAnagrams(letters, { exactLength: exact_length, maxResults: max_results });
+      return ok({ letters, count: words.length, words });
+    })
+  );
+  server.tool(
+    "tdk_rhymes",
+    "Bir kelime ile kafiyeli (son harfleri uyu\u015Fan) s\xF6zl\xFCk maddelerini bulur.",
+    {
+      word: import_zod.z.string().describe("Kafiyesi aranacak kelime."),
+      min_letters: import_zod.z.number().int().min(1).default(3).describe("Uyu\u015Fmas\u0131 gereken en az son harf say\u0131s\u0131."),
+      max_results: import_zod.z.number().int().min(1).max(500).default(50).describe("En fazla sonu\xE7 say\u0131s\u0131.")
+    },
+    guard(async ({ word, min_letters, max_results }) => {
+      const rhymes = await TDK.findRhymes(word, { minLetters: min_letters, maxResults: max_results });
+      return ok({ word, count: rhymes.length, rhymes });
+    })
+  );
+  server.tool(
+    "tdk_compare",
+    "\u0130ki kelimeyi anlam say\u0131s\u0131, k\xF6ken, hece b\xF6l\xFCn\xFC\u015F\xFC ve \xFCnl\xFC uyumu a\xE7\u0131s\u0131ndan kar\u015F\u0131la\u015Ft\u0131r\u0131r.",
+    {
+      a: import_zod.z.string().describe("Birinci kelime."),
+      b: import_zod.z.string().describe("\u0130kinci kelime.")
+    },
+    guard(async ({ a, b }) => ok(await TDK.compareWords(a, b)))
+  );
+  server.tool(
+    "tdk_audio_url",
+    "Bir kelimenin TDK seslendirme (.wav) URL'sini d\xF6nd\xFCr\xFCr (bulunamazsa null).",
+    { word: import_zod.z.string().describe("Seslendirmesi aranacak kelime.") },
+    guard(async ({ word }) => ok({ word, audioUrl: await TDK.getAudioUrl(word) }))
+  );
+  server.tool(
+    "tdk_word_of_the_day",
+    "TDK'nin 'g\xFCn\xFCn kelimesi'ni anlamlar\u0131yla d\xF6nd\xFCr\xFCr.",
+    {},
+    guard(async () => {
+      const wotd = await TDK.getWordOfTheDay();
+      return wotd ? ok(wotd) : fail("G\xFCn\xFCn kelimesi al\u0131namad\u0131.");
+    })
+  );
+  server.tool(
+    "tdk_random_word",
+    "TDK i\xE7eri\u011Finden rastgele bir kelime ya da atas\xF6z\xFC d\xF6nd\xFCr\xFCr.",
+    {},
+    guard(async () => {
+      const pick = await TDK.getRandomWord();
+      return pick ? ok(pick) : fail("Rastgele i\xE7erik al\u0131namad\u0131.");
+    })
+  );
+  server.tool(
+    "tdk_rules",
+    "TDK Yaz\u0131m K\u0131lavuzu kurallar\u0131n\u0131 listeler; 'name' verilirse o kural\u0131n tam metnini d\xF6nd\xFCr\xFCr.",
+    {
+      name: import_zod.z.string().optional().describe("\u0130stenirse tek bir kural\u0131n ad\u0131 (\xF6rn: 'Ba\u011Fla\xE7 Olan da, de'nin Yaz\u0131l\u0131\u015F\u0131').")
+    },
+    guard(async ({ name }) => {
+      if (name) {
+        const rule = await TDK.getRule(name);
+        return rule ? ok({ name, rule }) : fail(`"${name}" kural\u0131 bulunamad\u0131.`);
+      }
+      const rules = await TDK.getKurallar();
+      return ok({ count: rules.length, rules });
+    })
+  );
+  return server;
+}
+async function runMcpServer() {
+  const server = createMcpServer();
+  const transport = new import_stdio.StdioServerTransport();
+  await server.connect(transport);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TDK,
@@ -2513,11 +2770,13 @@ var TDKClient = class {
   TDKValidationError,
   TURKISH_SUFFIXES,
   TURKISH_VOWELS,
+  createMcpServer,
   getStemCandidates,
   isVowel,
   restoreConsonantSoftening,
   restoreGemination,
   restoreInfinitive,
   restoreVowelDrop,
-  restoreVowelNarrowing
+  restoreVowelNarrowing,
+  runMcpServer
 });

package/dist/index.mjs

@@ -1,3 +1,7 @@
+import {
+  createMcpServer,
+  runMcpServer
+} from "./chunk-ZG7YRT7V.mjs";
 import {
   TDK,
   TDKClient,
@@ -13,7 +17,7 @@ import {
   restoreInfinitive,
   restoreVowelDrop,
   restoreVowelNarrowing
-} from "./chunk-ZFWZXNGY.mjs";
+} from "./chunk-YY4WA2AO.mjs";
 export {
   TDK,
   TDKClient,
@@ -22,11 +26,13 @@ export {
   TDKValidationError,
   TURKISH_SUFFIXES,
   TURKISH_VOWELS,
+  createMcpServer,
   getStemCandidates,
   isVowel,
   restoreConsonantSoftening,
   restoreGemination,
   restoreInfinitive,
   restoreVowelDrop,
-  restoreVowelNarrowing
+  restoreVowelNarrowing,
+  runMcpServer
 };