tdk-api-wrapper 1.6.0 → 1.7.0

package/dist/cli.mjs

@@ -48,7 +48,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "repl",
   "kubbealti",
   "nisanyan",
-  "viki"
+  "viki",
+  "mcp"
 ]);
 var command = args[0];
 var word = args.slice(1).join(" ");
@@ -135,6 +136,12 @@ async function startRepl() {
   });
 }
 async function run() {
+  const binaryName = (process.argv[1] || "").toLowerCase();
+  if (command === "mcp" || rawArgs.includes("--mcp") || binaryName.includes("tdk-mcp")) {
+    const { runMcpServer } = await import("./mcp-NAXIX4TQ.mjs");
+    await runMcpServer();
+    return;
+  }
   if (!command) {
     if (process.stdin.isTTY) {
       await startRepl();
@@ -142,19 +149,19 @@ async function run() {
     }
     console.log("Kullan\u0131m: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki, mcp"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(1);
   }
   if (command === "--version" || command === "-v") {
-    console.log("tdk-api-wrapper v1.5.1");
+    console.log("tdk-api-wrapper v1.7.0");
     process.exit(0);
   }
   if (command === "--help" || command === "-h") {
     console.log("Kullan\u0131m: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki, mcp"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(0);

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
 interface Author {
     yazar_id: string;
     tam_adi: string;
@@ -685,4 +687,16 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing };
+/**
+ * Builds the TDK MCP server: every meaningful `TDK` static method is surfaced
+ * as a Model Context Protocol tool so an LLM client (Claude Desktop, Cursor,
+ * Antigravity, …) can query Turkish dictionary, morphology, spelling and
+ * etymology data directly. All tools return JSON text; network/scraping
+ * failures come back as `{ "error": ... }` with `isError: true` rather than
+ * throwing.
+ */
+declare function createMcpServer(): McpServer;
+/** Starts the TDK MCP server over stdio (used by the `tdk mcp` CLI command). */
+declare function runMcpServer(): Promise<void>;
+
+export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, createMcpServer, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing, runMcpServer };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
 interface Author {
     yazar_id: string;
     tam_adi: string;
@@ -685,4 +687,16 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing };
+/**
+ * Builds the TDK MCP server: every meaningful `TDK` static method is surfaced
+ * as a Model Context Protocol tool so an LLM client (Claude Desktop, Cursor,
+ * Antigravity, …) can query Turkish dictionary, morphology, spelling and
+ * etymology data directly. All tools return JSON text; network/scraping
+ * failures come back as `{ "error": ... }` with `isError: true` rather than
+ * throwing.
+ */
+declare function createMcpServer(): McpServer;
+/** Starts the TDK MCP server over stdio (used by the `tdk mcp` CLI command). */
+declare function runMcpServer(): Promise<void>;
+
+export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, createMcpServer, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing, runMcpServer };

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);
 
@@ -2504,6 +2506,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 +2786,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-MELLECWT.mjs";
 import {
   TDK,
   TDKClient,
@@ -22,11 +26,13 @@ export {
   TDKValidationError,
   TURKISH_SUFFIXES,
   TURKISH_VOWELS,
+  createMcpServer,
   getStemCandidates,
   isVowel,
   restoreConsonantSoftening,
   restoreGemination,
   restoreInfinitive,
   restoreVowelDrop,
-  restoreVowelNarrowing
+  restoreVowelNarrowing,
+  runMcpServer
 };

package/dist/mcp-NAXIX4TQ.mjs

@@ -0,0 +1,9 @@
+import {
+  createMcpServer,
+  runMcpServer
+} from "./chunk-MELLECWT.mjs";
+import "./chunk-ZFWZXNGY.mjs";
+export {
+  createMcpServer,
+  runMcpServer
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "tdk-api-wrapper",
-  "version": "1.6.0",
-  "description": "TDK (Türk Dil Kurumu) unofficial live data API wrapper for Node.js",
+  "version": "1.7.0",
+  "description": "TDK (Türk Dil Kurumu) unofficial live data API wrapper and MCP server for Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "bin": {
-    "tdk": "dist/cli.js"
+    "tdk": "dist/cli.js",
+    "tdk-mcp": "dist/cli.js"
   },
   "exports": {
     ".": {
@@ -25,13 +26,40 @@
     "api",
     "turkish",
     "dictionary",
-    "turkce"
+    "turkce",
+    "sozluk.gov.tr",
+    "spell-check",
+    "morphology",
+    "kubbealti",
+    "nisanyan",
+    "wiktionary",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol"
   ],
-  "author": "",
+  "author": "cemyilmazzzz122 <cemyleo12@icloud.com> (https://github.com/cemyilmazzzz122)",
   "license": "MIT",
+  "homepage": "https://github.com/cemyilmazzzz122/tdk-api#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cemyilmazzzz122/tdk-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cemyilmazzzz122/tdk-api/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsup": "^8.0.2",
     "typescript": "^5.4.5"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.0 || ^4.0.0"
   }
 }

package/.github/workflows/publish.yml

@@ -1,41 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    branches: [main]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: npm ci
-
-      - name: Check if version changed
-        id: version-check
-        run: |
-          LOCAL_VERSION=$(node -p "require('./package.json').version")
-          PKG_NAME=$(node -p "require('./package.json').name")
-          PUBLISHED_VERSION=$(npm view "$PKG_NAME" version 2>/dev/null || echo "0.0.0")
-          echo "Local: $LOCAL_VERSION / Published: $PUBLISHED_VERSION"
-          if [ "$LOCAL_VERSION" != "$PUBLISHED_VERSION" ]; then
-            echo "changed=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "changed=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Build
-        if: steps.version-check.outputs.changed == 'true'
-        run: npm run build
-
-      - name: Publish
-        if: steps.version-check.outputs.changed == 'true'
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}