Tephra

Tephra MCP

Tephra 的文档和配置示例。Tephra 是托管式远程 MCP 服务：一个由你的账户绑定、供 AI 工具共享的记忆。你连接的工具可以从中检索信息，也可以向其中添加内容。本仓库不包含源代码；Tephra 是 Obsidian Metrics 提供的付费托管服务。

• 服务 URL（Streamable HTTP）：https://tephra.obsidian-metrics.com/mcp
• 连接方式：添加服务 URL。支持 MCP OAuth 的客户端可通过客户端使用 Obsidian 账户登录；其他客户端则需使用个人 AI 密钥（tpk_...）。不同客户端的登录支持情况有所不同，请查看对应的连接指南。
• 连接指南：CONNECT.md 和 https://tephra.obsidian-metrics.com/connect
• 注册表元数据：server.json；客户端配置示例：mcp-config-examples.json

功能

• 供 AI 工具共享的记忆。 连接页面提供了 Claude（claude.ai、Desktop 和移动端）、ChatGPT、VS Code（GitHub Copilot）、Cursor、Claude Code、Gemini CLI、Windsurf、Zed、Mistral Le Chat、Perplexity，以及任何可以添加远程 MCP 服务的应用的连接步骤。每个已连接的工具都可以从同一记忆中检索信息并添加内容。
• 三个 MCP 工具（只读密钥只能使用前两个）：
  • tephra_recall：在你的记忆和共享知识库中进行排序检索。query 最多 4000 个字符；limit 为 1-50（默认值为 10）；可选的 keywords（关键词匹配部分最多 20 个精确词）、mode（semantic、keyword 或 hybrid）和 reader_order: "chronological"（相同记录按时间从早到晚排列，且每条记录都标有日期）。
  • tephra_search：在同一记忆中进行普通语义搜索，不包含 recall 的额外排序功能。query 最多 4000 个字符；limit 为 1-100（默认值为 10）。
  • tephra_remember：将一条记忆保存到你自己的账户，而非共享知识库。text 最多 8000 个字符；region 为可选项（不填写时由 Tephra 自动归类）；tags 最多 10 个；importance 为 1-5（默认值为 3）。Tephra 会添加 via-ai-key 标签，并报告记忆是否已存储。
• Tephra 对 MCP 的指引： recall、search 和 remember 的结果可能包含 <tephra_directions> 区块，其中会提供与 Tephra REST API 返回内容相同的指导：先检索再保存的指令；未进行近期检索便保存时发出的警告（标记为 blocked）；完整性说明；摘要页；以及“你可能遗漏的内容”列表。摘要页、遗漏列表和提醒会索引已存储的记录，并以围栏包裹并标注为数据，而非指令。服务的 initialize 指令要求 AI 在回答可能依赖已保存上下文的问题前调用 tephra_recall，并使用 tephra_remember 保存持久事实；AI 仍会自行决定何时调用这些工具。
• 混合检索： bge-m3 语义搜索与关键词匹配部分通过倒数排名融合，再经交叉编码器重新排序，并对关联记忆进行有界的两跳遍历。
• 默认按账户隔离： 每位成员都是独立租户；成员保存的所有内容都绑定到其账户，其他成员无法查看。
• 共享知识库： 公共知识（不含成员数据），每小时从 arXiv、PubMed、Federal Register 和 Crossref/OpenAlex 等来源获取内容并扩充；检索时会同时搜索该知识库和你自己的记忆。
• 控制与审计： 最多 10 个有效 AI 密钥，每个密钥都可撤销，也可设为只读，并拥有独立的活动日志；可通过已连接应用面板断开 OAuth 应用；支持编辑历史记录、编辑／删除／申诉记忆、导出数据（应用内）。
• MCP 密钥／结果的提示词注入防护：清除不可见字符、将记录限制在 4000 个字符以内，并将结果包装为笔记而非指令。
• **托管于 Cloudflare Workers 的远程 Streamable HTTP MCP 服务；**无需安装或自行托管。

限制

• Tephra 是付费产品：没有免费档。访问方式为 Premium（通过 Obsidian Metrics 社区按会员价每月 19 美元，直接订阅每月 29 美元），或一次性支付 399 美元购买 Tephra 席位，无需订阅；使用量不计费。会员资格失效后，密钥和连接将暂停。
• 速率限制：每个 AI 密钥或已连接的应用每分钟 60 个请求，所有会员共享的上限为每分钟 120 个请求。
• AI 必须调用 tephra_remember；Tephra 不会自动捕获聊天内容，也没有 Gmail、Slack 或 Drive 连接器。
• 不支持导入图像或音频。会员不能向共享库发布内容。

基准测试

LongMemEval-S，全部 500 个问题，检索前 10 条，使用 gpt-4o-2024-08-06 作为评判模型，运行一次：使用 gpt-4o 阅读器时为 85.2%；使用 Claude Opus 5.5 阅读器时为 95.2%（通过 Claude Code 子 Agent 运行）；检索结果相同。检索结果的前 10 条中至少包含一个所需会话的问题有 470 个中的 467 个，包含所有所需会话的问题有 435 个。这不是排名。