将不背单词的个人生词本接入 ChatGPT 的 MCP 服务，面向 ChatGPT Sites 私有部署。登录后，可以在对话中查看生词、移除指定单词、查看自定义词书，或创建新的自定义词书。
许可证：MIT
部署需要具备 Sites 创建、配置和发布能力的 ChatGPT 或 Codex。可以把仓库地址交给部署助手，并说明：
请阅读 AGENTS.md，将这个项目部署到我自己的 ChatGPT Sites，创建一个仅本人可访问的新站点。完成测试、发布和 MCP 插件接入。
发布后，使用 Sites 自动生成的插件连接服务。在 ChatGPT 中发送“登录不背单词”进行登录，如客户端无法展示登录二维码，可打开网页进行登录，网页和 MCP 共用同一份会话。
| 工具 | 示例 | 作用 |
|---|---|---|
start_login |
{} |
获取登录二维码 |
get_login_status |
{} |
查询扫码状态 |
logout |
{} |
清除当前服务会话 |
get_words |
{"count":10} 或 {} |
随机抽取或读取全部生词 |
remove_word |
{"word":"example"} |
移除指定生词并核验 |
list_books |
{} |
查看自定义词书及准确 code |
delete_book |
{"book_code":"词书code"} |
生成危险操作确认信息 |
import_words |
{"words":"...","exam":"考研"} |
创建自定义词书 |
import_words 的 words 和 exam 必填。exam 必须由用户从中考、高考、四级、六级、考研、专升本、雅思、其他中明确选择；去重并识别后需要 20–5000 个有效单词。
delete_book 是不可恢复的危险操作：第一次调用只返回词书名称、code、风险和一次性确认凭据。只有用户明确确认同一词书后，才能携带凭据再次调用。服务会重新读取词书列表，只有 deleted: true 且 verified: true 才算删除成功；结果不确定时不会自动重试。
站点应保持仅本人可访问，认证由 ChatGPT Sites 处理。官网 Cookie、登录任务和操作记录使用 BBDC_SESSION_KEY 加密后存入 R2。密钥只能配置在 Sites secret 中，不要写入源码、README、日志或 Git 提交。更换密钥会使已有加密会话无法读取。
| 路径 | 用途 |
|---|---|
lib/ |
官网接口、词汇操作、词书管理、导入逻辑和工具定义 |
worker/cloud.js |
Sites 请求处理与加密会话存储 |
worker/index.js |
自动生成的独立 Worker ESM |
web/index.html |
服务介绍与网页登录页面 |
scripts/ |
构建、检查和 Sites 配置脚本 |
templates/hosting.json |
无身份信息的 Sites 配置模板 |
test/ |
使用模拟响应的自动化测试 |
AGENTS.md |
部署助手的 Sites 工作流和安全约束 |