English Learning Ucb MCP

英语词汇UCB MCP服务器

部署在上的MCP（模型上下文协议）服务器 Cloudflare员工 管理英语词汇学习列表 基于UCB1的自适应排名设计用于实时语音代理，帮助说葡萄牙语的人学习英语。

运作原理

服务器维护一个英语单词及其葡萄牙语翻译的列表。每个单词都记录了它被问了多少次，以及学习者犯了多少错误。A. UCB1（置信上限） 算法对单词进行排序，以便：

• 从未尝试过的言语 地表优先（勘探）。
• 学习者难以理解的单词 靠近顶端（剥削）。
• 众所周知的词 自然沉入海底。

语音代理呼叫 get_next_word 选出最好的单词进行测验，然后打电话 record_attempt 在学习者做出回应之后。

UCB1公式

UCB(word) = exploitation + exploration

exploitation = errors / trials
exploration  = sqrt(2 * ln(N) / trials)

N = total trials across ALL words

单词with trials = 0 获得最高分，所以他们总是先练习。

MCP工具

先决条件

• v18+
• A. Cloudflare帐户
• 牧马人CLI v3+

设置

1.安装依赖项

npm install

2.创建D1数据库

npx wrangler d1 create vocabulary-db

复制 database_id 从输出并将其粘贴到 wrangler.toml:

[[d1_databases]]
binding = "DB"
database_name = "vocabulary-db"
database_id = ""

3.运行数据库迁移

当地（发展）：

npx wrangler d1 execute vocabulary-db --file=./schema.sql

远程（用于生产）：

npx wrangler d1 execute vocabulary-db --file=./schema.sql --remote

4.地方发展

npm run dev

服务器将在以下时间启动 http://localhost:8787MCP终点位于 /mcp.

5.部署到Cloudflare

npm run deploy

您的MCP服务器将在 https://english-vocabulary-ucb-mcp..workers.dev.

连接到克劳德桌面

将以下内容添加到您的Claude Desktop MCP配置文件中(claude_desktop_config.json):

{
  "mcpServers": {
    "english-vocabulary": {
      "type": "streamable-http",
      "url": "https://english-vocabulary-ucb-mcp..workers.dev/mcp"
    }
  }
}

连接到Claude代理（SDK）

使用Claude Agent SDK或任何兼容MCP的客户端时，请将其指向您部署的worker /mcp 使用流式HTTP传输的端点：

https://english-vocabulary-ucb-mcp..workers.dev/mcp

项目结构

/
├── src/
│   ├── index.ts          # Worker entrypoint + MCP server setup
│   ├── tools/            # One file per MCP tool
│   │   ├── index.ts      # Registers all tools
│   │   ├── add-word.ts
│   │   ├── list-words.ts
│   │   ├── get-next-word.ts
│   │   ├── record-attempt.ts
│   │   ├── remove-word.ts
│   │   ├── update-word.ts
│   │   └── get-stats.ts
│   ├── db/
│   │   ├── schema.ts     # TypeScript type definitions
│   │   └── queries.ts    # D1 query helpers
│   └── ucb.ts            # UCB1 calculation logic
├── schema.sql            # D1 migration file
├── wrangler.toml         # Cloudflare Workers config
├── tsconfig.json
├── package.json
└── README.md

NPM脚本

许可证

麻省理工学院