每日单词 MCP 服务器

这是一个使用了令人惊叹的 Free Dictionary API 提供单词定义和随机每日单词功能的模型上下文协议（MCP）服务器！🎉

🙏 特别感谢

特别感谢 Free Dictionary API 团队提供这个出色的、免费且开源的词典服务！没有他们的 API 提供全面的单词定义、发音、示例等信息，这个项目是不可能实现的。

API 端点： https://api.dictionaryapi.dev/api/v2/entries/en/<word>

功能

• 获取单词定义：获取任何英文单词的全面定义、发音、含义和示例
• 随机每日单词：获取一个随机单词及其定义，并按难度级别分类
• 丰富信息：包括音标发音、词性、示例、同义词、反义词以及可用时的词源

安装

1. 克隆或下载此项目
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

使用方法

作为 MCP 服务器

该服务器配置为通过 MCP 协议运行。将其添加到您的 MCP 客户端配置中：

{
  "mcpServers": {
    "word-of-the-day": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/Word_of_the_day"
    }
  }
}

🛠️ 可用的 MCP 工具

此服务器提供了两个强大的工具来增强词汇量：

📖 get_word_definition

描述：使用词典 API 获取任何英文单词的全面定义、发音和含义。

输入模式：

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string",
      "description": "要获取定义的单词"
    },
    "language": {
      "type": "string", 
      "description": "语言代码（默认：en）",
      "default": "en"
    }
  },
  "required": ["word"]
}

示例用法：

{
  "name": "get_word_definition",
  "arguments": {
    "word": "serendipity"
  }
}

示例响应：

**serendipity**

**发音**：/ˌsɛɹənˈdɪpɪti/

**含义：**

1. **名词**
   1. 不经意的发现或发现；意外惊喜。
      *示例*："一次幸运的偶然相遇使两位老朋友重逢。"
   2. 发现有价值或令人愉快的事物的能力或现象，这些事物并非刻意寻找。

**音频发音：**
1. https://api.dictionaryapi.dev/media/pronunciations/en/serendipity-us.mp3

---

🎲 get_random_word

描述：获取一个随机单词及其完整的定义，用于日常词汇建设，按难度级别分类。

输入模式：

{
  "type": "object",
  "properties": {
    "difficulty": {
      "type": "string",
      "enum": ["easy", "medium", "hard"],
      "description": "随机单词的难度级别",
      "default": "medium"
    }
  },
  "required": []
}

示例用法：

{
  "name": "get_random_word",
  "arguments": {
    "difficulty": "hard"
  }
}

示例响应：

**surreptitious** 🕵️

**发音**：/ˌsʌɹɪpˈtɪʃəs/

**含义：**

1. **形容词**
   1. 偷偷摸摸的，隐秘的，隐藏得很好的（尤其是动作）。

**音频发音：**
1. https://api.dictionaryapi.dev/media/pronunciations/en/surreptitious-us.mp3

难度级别：

• 简单：常见的日常词汇（happy, house, water, light, music, friend）
• 中等：更复杂的词汇（serendipity, eloquent, resilient, magnificent）
• 困难：高级词汇（ephemeral, ubiquitous, perspicacious, surreptitious）

📚 API 集成

此服务器集成了 Free Dictionary API —— 这是一个完全免费、开源的词典 API，不需要身份验证！

我们为什么喜欢这个 API：

• ✅ 完全免费 —— 没有 API 密钥或速率限制
• ✅ 开源 —— 社区驱动项目
• ✅ 全面数据 —— 丰富的单词信息
• ✅ 无需身份验证 —— 直接请求并获取数据！

API 提供：

• 单词定义和含义
• 音标发音（文本和音频）
• 词性信息
• 使用示例
• 同义词和反义词
• 词源/起源信息

单词难度级别

• 简单：常见的日常词汇（happy, house, water 等）
• 中等：更复杂的词汇（serendipity, eloquent, resilient 等）
• 困难：高级词汇（ephemeral, ubiquitous, perspicacious 等）

开发

• 开发模式：npm run dev
• 构建：npm run build
• 启动：npm start

示例响应

当你请求 "hello" 的定义时，你会得到：

**hello**

**发音**：həˈləʊ, hɛˈləʊ

**来源**：19世纪初：早期 hollo 的变体；与 holla 相关。

**含义：**

1. **感叹词**
   1. 用于问候或开始电话对话。
      *示例*："hello there, Katie!"

2. **名词**
   1. “hello”的发音；问候。
      *示例*："她得到了人们的礼貌点头和问候"

3. **动词**
   1. 说或喊“hello”。
      *示例*："我按下电话按钮并说了 hello"

**音频发音：**
1. //ssl.gstatic.com/dictionary/static/sounds/20200429/hello--_gb_1.mp3

错误处理

服务器优雅地处理：

• 字典中未找到的单词
• API 连接问题
• 无效参数
• 网络超时

许可证

本项目是开源的，采用 MIT 许可证。

---

由 Traves Theberge 制作 ❤️