MIT License
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 installBuild 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 devBuild:
npm run buildStart:
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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides comprehensive word definitions, pronunciations, meanings, and examples for any English word using the Free Dictionary API. Includes a random word-of-the-day feature with difficulty levels for vocabulary building.
Related MCP Servers
- -securityAlicense-qualitySemantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.Last updated -64MIT License
- AsecurityFlicenseAqualityExtracts structured dictionary data from the Longman Dictionary of Contemporary English website and serves it via Model Context Protocol, enabling AI agents to access detailed word definitions, examples, and linguistic information.Last updated -13
- AsecurityFlicenseAqualitySearches and queries the official minecraft wiki to answer any minecraft-related question with precision!Last updated -96