MCP Turkish Dictionary API (mcp-turkce)

Model Context Protocol Server for Turkish Language Foundation (TDK) API. This server provides access to Turkish dictionaries, including the main Turkish dictionary, etymology, dialects, and specialized terminology via Model Context Protocol (MCP).

This project is a wrapper for the official Turkish Language Foundation (TDK) dictionary API available at https://sozluk.gov.tr/.

Features

• Main Dictionaries

  • General Turkish Dictionary (GTS)
  • Western-origin words
  • Scanning dictionary
  • Compilation dictionary

• Specialized Dictionaries

  • Proverbs and idioms
  • Foreign words guide
  • Etymology dictionary
  • Origin information

• Person Names Dictionaries

  • Male names
  • Female names
  • Unisex names
  • Search by name meaning

• Dialect Dictionaries

  • Turkish dialects (Azerbaijani, Kazakh, etc.)

• Science and Art Terminology

  • Multiple specialized dictionaries (Medicine, Biology, etc.)
  • Nursing terminology
  • Pharmacy terminology
  • Metrology terminology
  • Veterinary terminology

Installation

npm install mcp-turkce

Or to install globally:

npm install -g mcp-turkce

Usage

Running the MCP Server

npx mcp-turkce

Or if installed globally:

mcp-turkce

This will start the MCP server, which you can then use with your MCP client.

Usage with Claude Desktop

1. Start the server using the command above
2. Add the server ID to Claude Desktop
3. Use the tools provided by the server to interact with Turkish dictionaries

Claude Integration Configuration

Add the following to your Claude configuration:

{
    "sozluk": {
        "command": "npx",
        "args": ["-y", "mcp-turkce"]
    }
}

API Example

If you want to use the API directly, you can import it in your own project:

import { TurkishDictionaryAPI } from 'mcp-turkce/api';

async function main() {
  const api = new TurkishDictionaryAPI();
  
  // Search the main Turkish dictionary
  const result = await api.searchWord('adalet');
  console.log(result);
  
  // Search for proverbs and idioms
  const proverbs = await api.searchProverbsAndIdioms('göz');
  console.log(proverbs);
}

main();

Check the test.ts file for more comprehensive examples.

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run the test
npm run test

# Run the inspector for debugging
npm run inspector

License

MIT

Author

kiliczsh