vocabflip

专业英语词汇学习小站，为涉外知产从业者打造，也适用于任何需要系统学习领域词汇的场景。

功能

• 翻卡片学词 — 正面英文，翻面显示中文释义、音标和例句，一键标记"已掌握"或"需复习"
• 实战例句 — 来自真实官方文件的原句，关键词高亮展示
• 阅读练习 — PCT/知产真实语料，配套阅读理解题
• 知识测验 — 选择题，即时反馈，查漏补缺
• 学习统计 — 每日进度、批次管理、完成率一览
• MCP 工具接入 — AI 助手可直接查询今日进度、添加词汇、查看整体进度
• 背景持久化 — 上传自定义背景图，刷新不丢失
• 主题切换 — 浅色 / 深色 / 黑白三种主题

技术栈

• 后端：Python / Flask / SQLite
• 前端：原生 HTML + CSS + JS（无框架，移动端友好）
• MCP：FastMCP

快速开始

git clone https://github.com/Nixie0/vocabflip.git
cd vocabflip
pip install flask fastmcp

# 启动 Web（端口 5002）
python app.py

# 启动 MCP 服务（端口 8771，可选）
python mcp_server.py

浏览器打开 http://localhost:5002 即可使用。

MCP 工具列表

工具名	功能
vocab_check_today	查看今日学习情况
vocab_add_words	批量添加新词（JSON 格式）
vocab_get_all_progress	查询所有批次的整体进度

MCP 服务使用 SSE 传输，默认端口 8771。

添加自己的词汇

通过 vocab_add_words 传入 JSON 数组：

[
  {
    "word": "prior art",
    "phonetic": "/ˈpraɪər ɑːrt/",
    "meaning": "现有技术",
    "example": "The invention must be novel over the prior art."
  }
]

也可以直接操作 vocab.db 写入 SQLite 数据库。

License

MIT