Vozclara

VozClara

多语言 AI 学习工具。粘贴任意公开视频 URL → 即可用你的母语获取结构化知识包（摘要、关键观点、术语表、测验、带时间戳的文字稿）：西班牙语、葡萄牙语、德语、英语。

在线体验：vozclara.app MCP 服务：smithery.ai/server/salvador7eon/vozclara

态度传统，工具现代。

---

MCP 集成

VozClara 提供 Model Context Protocol（MCP）服务，供 AI Agent（Claude Desktop、Cursor、Claude Code、Continue、搭配 Copilot Chat 的 VS Code 等）直接调用。

通过 Smithery 一键安装 → 选择你的客户端 → 完成。

Claude Desktop 手动配置（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "vozclara": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vozclara.app/api/mcp"]
    }
  }
}

重启 Claude Desktop 并询问：

“使用 vozclara 用德语总结这段视频：https://www.youtube.com/watch?v=…”

可用工具

匿名端点（/api/mcp）提供一个无需登录即可使用的工具。受 OAuth 保护的端点（/api/mcp/pro）则额外提供三个操作用户本人 VozClara 知识库的工具。

工具	端点	输入	输出
vozclara_generate_pack	/api/mcp（匿名）	url、language（es/pt/de/en）、depth（short/standard/deep）	知识包文本 + 结构化元数据 + 指向 vozclara.app 上交互式知识包的深层链接
vozclara_search_my_library	/api/mcp/pro（OAuth）	query、可选的 limit（1-10）	对已认证用户的知识包进行语义搜索，返回的每条结果都附有指向 vozclara.app 的链接
vozclara_ask_video	/api/mcp/pro（OAuth）	pack_id、question	基于 RAG 的回答，附带行内引用，严格仅依据该知识包
vozclara_export_anki	/api/mcp/pro（OAuth）	pack_id	深层链接 URL，用户打开后即可下载 .apkg 卡组

已认证配置（Claude Desktop，付费层级工具——额外提供上述三个限定于知识库范围的工具）：

{
  "mcpServers": {
    "vozclara-pro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vozclara.app/api/mcp/pro"]
    }
  }
}

首次调用时，mcp-remote 会打开浏览器，你使用魔法链接登录并批准权限范围（library:read、library:write、profile），随后刷新令牌会缓存在本地——流程与 GitHub 的 MCP 服务相同。

Claude Skills 技能包

这是对上述原始 MCP 工具的高层配套功能。此仓库中的 skills/ 包含三个可安装的 Claude Skills，可将日常的视频、知识和学习请求路由至 VozClara MCP 服务——因此 Claude 能判断何时调用 vozclara_generate_pack、vozclara_search_my_library 或 vozclara_ask_video，无需用户记住工具名称。

mkdir -p ~/.claude/skills
cp -R skills/vozclara-* ~/.claude/skills/

重启 Claude Desktop（或在 Claude Code 中运行 /reload-skills）。这些技能会显示在选择器中。有关每个技能的触发方式，以及两个付费层级技能的 OAuth 流程，请参阅 skills/README.md。

---

技术栈

层	技术
前端	Cloudflare Pages 上的 Vite + React 18 + TypeScript + Tailwind
Worker	Cloudflare Workers + Durable Objects + KV + D1 + Vectorize
大模型（免费版 / Pro）	Workers AI · @cf/meta/llama-3.3-70b-instruct-fp8-fast
大模型（Pro Plus）	通过 Cloudflare AI Gateway 提供的 Anthropic Claude Sonnet 4.5
文字稿	Supadata（持证的 Merchant-of-Record）
嵌入	用于语义搜索的 @cf/baai/bge-base-en-v1.5
TTS	OpenAI tts-1（可选，高级语音讲解）
身份验证	通过 Resend 发送魔法链接，无需密码
支付	Paddle（Merchant-of-Record，负责处理欧盟 VAT 和美国销售税）
MCP	agents SDK + McpAgent +（第二阶段）workers-oauth-provider
分析	Cloudflare Web Analytics（无 Cookie，无需征得同意的横幅）

---

本地开发

前置条件：Node 20+、Git。

# Install
npm install
npm --prefix worker install

# Two terminals — Vite dev server + Wrangler dev
# Terminal A: Vite on :5173
npm run dev
# Terminal B: Wrangler on :8787
npm run worker:dev

Vite 会将 /api/* 代理到 :8787，因此 http://localhost:5173 可以端到端正常运行。

要让 worker 在本地调用 Supadata，请在 worker/ 中放置一个 .dev.vars 文件：

SUPADATA_API_KEY=sd_…
# Optional — enables OpenAI TTS path
OPENAI_API_KEY=sk-…
# Optional — enables Sonnet 4.5 for Pro Plus tier
ANTHROPIC_API_KEY=sk-ant-…

该文件已加入 Git 忽略列表。生产环境密钥请改用 wrangler secret put <NAME> 设置。

---

部署

前端 → Cloudflare Pages

npm run build
# Push to GitHub; Cloudflare Pages builds dist/ automatically.
# Custom domain: vozclara.app

Worker → Cloudflare Workers

cd worker
npx wrangler deploy

这会将 API + MCP 服务部署到 vozclara.app/api/*，并部署到对应的 Smithery URL：https://vozclara--salvador7eon.run.tools。

---

合规

• DSGVO Art. 13 — 完整的子处理方列表见 /privacy
• DSGVO Art. 17 — 服务端账号删除会清除电子邮件、会话、投票和评价
• EU AI Act Art. 50(1) — 首次访问生成器时显示 AI 披露横幅
• EU AI Act Art. 50(2) — 每个导出的包都带有 AI 生成水印
• 退款政策 — /refund 提供 14 天退款保证

---

品牌

LEON MARÉ 编辑风格：

• 颜色 — 海军蓝 #0A1A3A、金色 #C9A24B、奶油色 #F7F3EC、石墨色 #1A1A1A
• 字体 — 按地区设置：Reforma（ES）、Adelle Sans（PT）、Inter（DE）、Tiempos（EN）
• 语调 — 古典、陈述式，不使用感叹号、表情符号或最高级表达

---

VozClara · LEON MARÉ 出品 · Frankfurt am Main · Donostia · Porto