Vocab Voyage

Vocab Voyage MCP 服务

Vocab Voyage Model Context Protocol 服务的官方公开镜像——提供 20 个工具 + 17 个交互式小组件，用于词汇学习和标准化考试备考（ISEE、SSAT、SAT、PSAT、GRE、GMAT、LSAT）。

• 20 个 MCP 工具（包括抽认卡、11 款小游戏、进度跟踪和 Sparkle 辅导）

• 17 个交互式小组件（测验、抽认卡、学习计划、进度仪表板、学习回顾等）

• 托管服务——无需安装

• 可选个人令牌，用于个性化功能

• 🔗 服务 URL：https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server

• 📚 浏览工具：https://vocab.voyage/mcp/tools

• 🛠 身份验证和作用域：https://vocab.voyage/developers/auth

• 🪪 许可证：MIT

安装

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "vocab-voyage": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server"]
    }
  }
}

ChatGPT Apps SDK / Cursor / Cline

添加自定义远程 MCP 服务，使用上方的 URL，并可选择提供通过 https://vocab.voyage/developers/auth 生成的 Bearer vv_mcp_… 令牌。

OpenClaw

openclaw skills install vocab-voyage

工具

工具数量：20。

• get_word_of_the_day — 返回今日词汇，可按考试类别筛选。
• get_definition（适配小组件）— 查询单词的释义、词性、例句以及同义词和反义词。
• generate_quiz（适配小组件）— 为指定考试类别生成选择题词汇测验（1–10 道题）。
• get_course_word_list — 获取特定 Vocab Voyage 课程中的词汇样例。
• list_courses — 列出全部 13 门 Vocab Voyage 课程及其 slug 和说明。
• explain_word_in_context — 解释某个单词在特定句子中的含义。
• study_plan_preview（适配小组件）— 为指定考试类别提供 7 天学习计划样例（每天 5 个单词）。
• get_flashcards（适配小组件）— 返回点击翻面的抽认卡组。每张卡片的答案会通过 record_word_result 持久保存。
• get_my_progress（适配小组件）— 仅限身份验证用户使用的个人仪表板：连续学习天数、XP、掌握情况分布、接下来要学的单词和近期答错的单词。
• play_game — 启动 11 款词汇小游戏之一（word_match、spelling_bee、speed_round、synonym_showdown、word_scramble、fill_in_blank、context_clues、word_guess、picture_match、crossword、word_search）。每道题的事件会传递给 record_word_result；每轮 XP 通过 award_game_xp 发放。
• get_sparkle_guidance（适配小组件）— 感知学习生命周期的辅导功能：返回适合当前阶段的问候语（共 16 个阶段）和建议使用的下一项工具/操作。相关时会显示学习回顾小组件。
• set_persona — 在 student、parent、tutor 或 explorer 之间切换 Agent 的倾向。
• get_recommended_next_action — 返回一行关于用户下一步应做什么的建议。
• list_starter_prompts — 为不显示 prompts/list 的宿主列出 6 个 MCP 提示词（vocab_kickoff、test_prep_quiz、session_debrief 等）。
• record_word_result — 需身份验证：记录每张卡片的答案（正确或错误）。
• record_session_complete — 需身份验证：记录学习环节总数据并发放 XP。
• award_game_xp — 需身份验证：为已完成的小游戏回合发放奖励 XP。
• mark_word_known — 需身份验证：将单词添加到用户的待学队列或已掌握列表。
• mark_word_difficult — 需身份验证：标记需要更多复习的单词。
• update_adaptive_level — 需身份验证：调整用户的自适应难度下限和上限。

小组件

小组件数量：17 个。

• ui://vocab-voyage/word-of-the-day — 每日单词（学习，560x360），通过 get_word_of_the_day
• ui://vocab-voyage/flashcards — 闪卡（学习，560x460），通过 get_flashcards
• ui://vocab-voyage/quiz — 测验（学习，560x520），通过 generate_quiz
• ui://vocab-voyage/study-plan — 学习计划（学习，600x600），通过 study_plan_preview
• ui://vocab-voyage/progress — 我的进度（进度，600x640），通过 get_my_progress
• ui://vocab-voyage/game/word_match — 游戏 · 单词配对（游玩，620x640），通过 play_game
• ui://vocab-voyage/game/spelling_bee — 游戏 · 拼写挑战（游玩，560x580），通过 play_game
• ui://vocab-voyage/game/speed_round — 游戏 · 速度挑战（游玩，560x600），通过 play_game
• ui://vocab-voyage/game/synonym_showdown — 游戏 · 同义词对决（游玩，560x580），通过 play_game
• ui://vocab-voyage/game/word_scramble — 游戏 · 单词重组（游玩，560x580），通过 play_game
• ui://vocab-voyage/game/fill_in_blank — 游戏 · 填空（游玩，560x600），通过 play_game
• ui://vocab-voyage/game/context_clues — 游戏 · 语境线索（游玩，600x620），通过 play_game
• ui://vocab-voyage/game/word_guess — 游戏 · 猜单词（游玩，560x600），通过 play_game
• ui://vocab-voyage/game/picture_match — 游戏 · 图片配对（游玩，600x620），通过 play_game
• ui://vocab-voyage/game/crossword — 游戏 · 填字游戏（游玩，640x720），通过 play_game
• ui://vocab-voyage/game/word_search — 游戏 · 找单词（游玩，640x720），通过 play_game
• ui://vocab-voyage/session-debrief — 学习回顾（辅导，600x640），通过 get_sparkle_guidance

示例

• examples/curl-quiz.sh — 使用 curl 生成包含 5 道题的 SAT 测验
• examples/node-flashcards.mjs — 从 Node 18+ 获取一组闪卡
• examples/python-progress.py — 从 Python 调用仅限身份验证的 get_my_progress 工具

清单

用于发现和提交目录的文件均直接放在仓库根目录，以便 MCP 目录可以执行 git clone 并直接链接到这些文件：

• server-card.json — MCP 服务卡片（规范版本）
• apps.json — 交互式小组件目录
• agent-card.json — A2A Agent 卡片
• mcp.json — MCP 发现文档
• server.json — MCP Registry 提交清单
• smithery.yaml — Smithery 目录条目
• clawhub.json — ClawHub 目录条目
• SKILL.md — OpenClaw 技能描述文件
• SUBMISSION_LINKS.md — 规范的 ?ref= slug 列表 + Friday 归因查询

上述所有文件都会在每次发布时由上游的 scripts/build-mcp-repo.mjs 重新生成——请勿在此处手动编辑。

许可证

MIT © Vocab Voyage