项目简介
这是一个实现了Model Context Protocol (MCP) 的服务器端应用,专注于提供英语词典查询服务。它能够与兼容MCP协议的客户端(如AI助手)进行通信,为其提供单词的定义、发音、例句等详细信息,并支持通过预定义的Prompt进行深入的词汇学习。
主要功能点
- 单词查询: 通过 MCP 协议接收单词查询请求,返回详细的释义信息。
- 详细解析: 支持触发一个预定义的 Prompt,引导 AI 对目标单词进行多维度的深入分析和学习指导。
- MCP 集成: 无缝集成到支持 MCP 协议的 AI 工作流中,作为 AI 获取外部知识的工具。
- 数据源: 从外部剑桥词典API获取数据。
安装步骤
- 确保你的系统已安装 Node.js 和 npm。
- 克隆本仓库到本地。
- 在项目根目录打开终端,运行以下命令安装依赖:
npm install - 构建项目:
npm run build
服务器配置(供 MCP 客户端使用)
MCP 服务器由 MCP 客户端启动和管理。要将此词典服务器添加到你的 MCP 客户端中,你需要提供服务器的启动命令和参数。客户端通常需要以下信息:
- 服务器名称 (server name): 用于在客户端中标识这个服务器,例如 'mcp-server-cambridge-dict'。
- 命令 (command): 启动服务器的可执行文件或命令,例如 'npx'。
- 参数 (args): 传递给命令的参数,例如 '["-y", "mcp-server-dictionary"]'。这里的 'npx -y mcp-server-dictionary' 会通过 npm 执行预构建好的词典服务器。
请根据你的 MCP 客户端的具体配置界面或文件格式,填入相应的 'command' 和 'args' 信息。服务器启动后通常通过标准输入输出 (Stdio) 与客户端通信。
基本使用方法
- 首先,你需要启动 MCP 词典服务器。在项目根目录运行:
服务器会启动并在终端显示类似 'Dictionary MCP server running on stdio' 的信息。npm run start:mcp - 然后,启动你的 MCP 客户端(如兼容 MCP 的 AI 助手界面或工具)。
- 在 MCP 客户端中,确保已经配置并连接到此词典服务器。
- 你的 AI 助手现在可以通过 MCP 协议调用此服务器提供的功能。例如:
- AI 可能会调用 'lookup_word' 工具,并提供 '{"word": "example"}' 作为参数来查询“example”的定义。服务器会返回查询结果给 AI。
- AI 可能会触发名为 'Detailed-explanation' 的 Prompt 模板,提供 '{"word": "verbose"}' 等参数,服务器会返回预设好的引导 AI 深入学习“verbose”的Prompt内容。
- 最终查询结果或 Prompt 内容将由 MCP 客户端/AI 助手呈现给你。
信息
分类
AI与计算