Skip to main content
Glama

Word of the Day MCP Server

README.md5.69 kB
# Word of the Day MCP Server A Model Context Protocol (MCP) server that provides word definitions and random word-of-the-day functionality using the amazing **[Free Dictionary API](https://api.dictionaryapi.dev/)**! 🎉 ## 🙏 Special Thanks Huge shoutout to the **[Free Dictionary API](https://www.dictionaryapi.dev/)** team for providing this incredible, free, and open-source dictionary service! This project wouldn't be possible without their fantastic API that delivers comprehensive word definitions, pronunciations, examples, and more. **API Endpoint:** `https://api.dictionaryapi.dev/api/v2/entries/en/<word>` ## Features - **Get Word Definition**: Fetch comprehensive definitions, pronunciations, meanings, and examples for any English word - **Random Word of the Day**: Get a random word with its definition, categorized by difficulty level - **Rich Information**: Includes phonetic pronunciation, part of speech, examples, synonyms, antonyms, and etymology when available ## Installation 1. Clone or download this project 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` ## Usage ### As an MCP Server The server is configured to run via the MCP protocol. Add it to your MCP client configuration: ```json { "mcpServers": { "word-of-the-day": { "command": "node", "args": ["dist/index.js"], "cwd": "/path/to/Word_of_the_day" } } } ``` ## 🛠️ Available MCP Tools This server provides two powerful tools for vocabulary enhancement: ### 📖 `get_word_definition` **Description:** Get comprehensive definitions, pronunciations, and meanings of any English word using the Dictionary API. **Input Schema:** ```json { "type": "object", "properties": { "word": { "type": "string", "description": "The word to get the definition for" }, "language": { "type": "string", "description": "Language code (default: en)", "default": "en" } }, "required": ["word"] } ``` **Example Usage:** ```json { "name": "get_word_definition", "arguments": { "word": "serendipity" } } ``` **Sample Response:** ``` **serendipity** **Pronunciation:** /ˌsɛɹənˈdɪpɪti/ **Meanings:** 1. **noun** 1. An unsought finding or discovery; a pleasant surprise. *Example: "A fortunate stroke of serendipity brought the two old friends together."* 2. The faculty or phenomenon of finding valuable or agreeable things not sought for. **Audio Pronunciation:** 1. https://api.dictionaryapi.dev/media/pronunciations/en/serendipity-us.mp3 ``` --- ### 🎲 `get_random_word` **Description:** Get a random word with its complete definition for daily vocabulary building, categorized by difficulty level. **Input Schema:** ```json { "type": "object", "properties": { "difficulty": { "type": "string", "enum": ["easy", "medium", "hard"], "description": "Difficulty level of the random word", "default": "medium" } }, "required": [] } ``` **Example Usage:** ```json { "name": "get_random_word", "arguments": { "difficulty": "hard" } } ``` **Sample Response:** ``` **surreptitious** 🕵️ **Pronunciation:** /ˌsʌɹɪpˈtɪʃəs/ **Meanings:** 1. **adjective** 1. Stealthy, furtive, well hidden, covert (especially movements). **Audio Pronunciation:** 1. https://api.dictionaryapi.dev/media/pronunciations/en/surreptitious-us.mp3 ``` **Difficulty Levels:** - **Easy**: Common everyday words (happy, house, water, light, music, friend) - **Medium**: Sophisticated vocabulary (serendipity, eloquent, resilient, magnificent) - **Hard**: Advanced vocabulary (ephemeral, ubiquitous, perspicacious, surreptitious) ## 📚 API Integration This server integrates with the **[Free Dictionary API](https://api.dictionaryapi.dev/)** - a completely free, open-source dictionary API that requires no authentication! ### Why We Love This API: - ✅ **Completely FREE** - No API keys or rate limits - ✅ **Open Source** - Community-driven project - ✅ **Comprehensive Data** - Rich word information - ✅ **No Authentication** - Just make requests and get data! The API provides: - Word definitions and meanings - Phonetic pronunciations (text and audio) - Part of speech information - Usage examples - Synonyms and antonyms - Etymology/origin information ## Word Difficulty Levels - **Easy**: Common everyday words (happy, house, water, etc.) - **Medium**: More sophisticated vocabulary (serendipity, eloquent, resilient, etc.) - **Hard**: Advanced vocabulary (ephemeral, ubiquitous, perspicacious, etc.) ## Development - **Development mode**: `npm run dev` - **Build**: `npm run build` - **Start**: `npm start` ## Example Response When you request the definition of "hello", you'll get: ``` **hello** **Pronunciation:** həˈləʊ, hɛˈləʊ **Origin:** early 19th century: variant of earlier hollo ; related to holla. **Meanings:** 1. **exclamation** 1. used as a greeting or to begin a phone conversation. *Example: "hello there, Katie!"* 2. **noun** 1. an utterance of 'hello'; a greeting. *Example: "she was getting polite nods and hellos from people"* 3. **verb** 1. say or shout 'hello'. *Example: "I pressed the phone button and helloed"* **Audio Pronunciation:** 1. //ssl.gstatic.com/dictionary/static/sounds/20200429/hello--_gb_1.mp3 ``` ## Error Handling The server gracefully handles: - Words not found in the dictionary - API connection issues - Invalid parameters - Network timeouts ## License This project is open source and available under the MIT License. --- **Made with ❤️ by Traves Theberge**

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Traves-Theberge/Word_of_the_day'

If you have feedback or need assistance with the MCP directory API, please join our Discord server