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! 🎉
🙏 Special Thanks
Huge shoutout to the Free Dictionary API 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
- Clone or download this project
- Install dependencies:
npm install - Build the project:
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:
{
"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:
{
"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:
{
"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:
{
"type": "object",
"properties": {
"difficulty": {
"type": "string",
"enum": ["easy", "medium", "hard"],
"description": "Difficulty level of the random word",
"default": "medium"
}
},
"required": []
}
Example Usage:
{
"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 - 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