obsideo

Obsideo MCP 服务

为任何支持 MCP 的 Agent（Claude Desktop、Claude Code、Cursor、Cline……） 提供持久存储：数据会先在你的设备上加密，再上传；你还能独立证明数据仍由服务商持有。 无需设置：首次调用 put/get/ls 时会自动创建一个免费的免邮箱试用账户（100 MB，以工作量证明代替身份验证），存储开箱即用，无需配置。想要更多？ 在对话中自行注册，即可升级到 12 GB 免费存储，无需银行卡、无需 CAPTCHA，也永不过期。

Obsideo 是兼容 S3 的对象存储，每个存储对象都会复制到 3 家服务商，并持续接受块级 Merkle 证明挑战；服务商只有通过证明后才会获得付款。提供 12 GB 免费存储，只需邮箱，无需银行卡。付费方案按 200 GB 为一档，每档每月 $5，通过银行卡（Stripe）付款；从 upgrade 工具发起，并在 Stripe 自有页面完成付款；未经用户同意，方案容量绝不会变更。

隐私保护（请先阅读）

• 此服务在你的设备上运行。 Obsideo 绝不会托管它。凭据、账户签名密钥和加密密钥都保存在 ~/.obsideo/ 中，只会发送到进行身份验证的端点。
• 账户签名密钥在本地生成；只会发送公钥。请妥善保管 ~/.obsideo/signing.pem。重新注册会轮换凭据和密钥对，且新旧密钥不会重叠，因此请勿随意重新注册。
• 默认加密。 put 会在数据离开设备前使用本地生成、由用户持有的密钥在客户端进行加密（AES-256-GCM），因此从架构上说，平台只存储无法读取的密文。仅当其他工具需要直接读取存储的字节时（S3 互操作），才传入 encrypt: false。

备份密钥

创建账户时，加密密钥会在你的设备上生成，并写入 ~/.obsideo/mcp.json。Obsideo 不保留副本，也无法帮你恢复。 如果该文件丢失，所有加密对象都将永久无法读取，无论多少家服务商仍持有这些对象，也无论它们通过了多少次证明。 副本可防止服务商丢失你的数据字节，但无法防止你丢失密钥。注册后请立即调用 backup_keys 并指定保存位置，将存档保存在即使这台设备丢失后你仍能访问的地方。加密 对象只能使用此密钥读取：目前加密对象无法在不同人员或设备之间共享，因此请将一个账户视为供一人使用。

~/.obsideo/roots.json 会与密钥文件一同写入：其中记录每个对象上传时提交的 Merkle 根。该文件不包含机密信息，可让 verify 在无需重新上传数据的情况下证明服务商持有的正是你的数据。每次上传时都会使用新的 IV，因此之后无法从明文文件重新计算密文；此记录可确保加密对象仍能获得强证明。丢失该文件会削弱证明力度，但不会导致数据丢失。如果文件损坏，服务会原样将其移至别处，并在下一次结果中告知，而不是覆盖它。

安装

**Claude Desktop，一键安装：**从最新版本下载 obsideo-mcp.mcpb， 然后进入 Settings -> Extensions，将文件拖进去。无需设置 Node 或 npm。

其他所有客户端，通过 npx 安装：

{
  "mcpServers": {
    "obsideo": {
      "command": "npx",
      "args": ["-y", "obsideo-mcp"]
    }
  }
}

（Claude Desktop：claude_desktop_config.json。Claude Code： claude mcp add obsideo -- npx -y obsideo-mcp。Cursor/Cline：在其 MCP 设置中使用相同命令。）

**Hermes Agent：**将 https://obsideo.io/agent-storage 粘贴给 Hermes，并说“设置一下”。 该页面是 Agent 要执行的操作指南：安装、创建第一个存储空间、完成首次验证， 然后使用邮箱开通免费的 12 GB 套餐。它运行的安装命令在任何操作系统上都只有一条 （npx 需要 Node 18 或更高版本）：

hermes mcp add obsideo --command npx --args -y obsideo-mcp

它会将服务写入 Hermes 自己的配置，连接服务，列出 13 个工具并询问要启用哪些工具（如果不希望 Agent 拥有删除 工具，请不要启用 rm）。然后在运行中的会话里执行 /reload-mcp，或启动新会话。工具 会显示为 mcp_obsideo_put、mcp_obsideo_get、mcp_obsideo_verify 等。 手动配置的替代方法：将与上文相同的 mcpServers 块放在 Hermes 的 config.yaml 文件中的 mcp_servers: 键下。首先可以试试：让 Hermes 将自己的 MEMORY.md 存储到 obsideo，然后验证它。

工具

工具	功能
trial	创建即时免邮箱账户（100 MB、约 7 天、工作量证明，无需人工参与）。通常不需要：存储工具首次使用时会自动创建账户
signup_start	发送 6 位验证码（免费套餐为 12 GB；仅限真实邮箱，拒绝时会注明原因）。如果已配置试用账户，此操作会直接将其转为正式账户：账户、密钥和数据保持不变，配额提高
signup_verify	完成注册或账户转换。新账户会在本地生成签名密钥对并保存凭据；账户转换只会更改配额
put	存储文件或内联内容，默认在客户端加密（设置 encrypt: false 可选择退出加密）。如果未配置账户，则自动创建试用账户
get	获取对象（使用本地密钥自动解密）
ls	列出对象，可按前缀筛选
rm	删除对象
verify	证明网络仍保存着某个对象，无需下载
usage	显示已用存储空间与配额，以及套餐信息
backup_keys	将凭据、签名密钥、加密密钥和上传承诺复制到指定目标（.tar.gz 路径或文件夹）。没有默认目标：未指定目标时会拒绝操作。Obsideo 不保存密钥副本
plan	显示免费套餐或付费容量块、状态、周期结束时间，以及等待用户处理的任何优惠
upgrade	获取购买 N 个 200 GB 容量块的 Stripe 结账链接。不会扣费；由用户在 Stripe 页面付款。绝不会更改现有套餐
portal	获取 Stripe 门户链接，可取消套餐、更换银行卡和查看发票

付费，以及 Agent 可以执行的操作

upgrade 会返回一个链接，仅此而已。用户打开链接后，可以看到确切的 月费，然后选择付款或关闭标签页；付款后配额会提高。此服务绝不会调整现有套餐：在套餐配额 快用满时，Obsideo 会发送一封包含同意链接的邮件，只有用户点击该链接才会更改 账单。portal 会返回 Stripe 门户链接，可用于取消套餐、更换银行卡 和下载发票。取消套餐后，已存储的所有内容仍会保留且可读取；付费周期 结束时，账户会恢复为免费配额。

verify

直接挑战每个持有该对象的提供方，每个提供方随机选择一个分块，并将本机上的每个回答与 Merkle 根进行比较。对于由此服务上传的对象，该根是本地在上传时记录的根，因此验证通过意味着提供方持有的是你的字节，而不只是与其他提供方一致。对于在其他位置上传的对象，可以使用你传入的 local_path 文件进行检查。如果两者都没有，则会退回使用协调器的根，并说明这一点。

协调器仍会选择要询问哪些提供方以及如何连接它们、发放挑战令牌，并列出用于验证提供方签名的公钥。结果会指出依赖了其中哪些信息。如果提供方未能通过证明或无法接受挑战，结果会首先说明这一点，并且只对通过验证的提供方作出结论。

适用场景

应用文件存储、自动备份（数据库、快照、状态）、必须能在不同会话和机器之间留存的 Agent 制品与记忆，以及可证明的异地副本。它不是 CDN，不是可查询数据库，也不提供亚毫秒级存储；Obsideo 用于存储对象和备份制品。

完整集成契约（逐步后置条件、错误表）： obsideo.io/agents.md

传输方式

从 0.7.0 起，put / get / ls / rm 会与协调器及其指定的存储提供方通信，所用路径与 verify 一直以来使用的相同。不会经过 S3 网关，也无需等待新生成的凭据传播：账号的协调器 API 密钥在注册完成返回时即刻生效，因此注册后第一次 put 就能立即成功（生产环境实测为 0.8 秒）。早于协调器密钥的配置，或设置了 OBSIDEO_TRANSPORT=s3 的配置，仍会使用带 SigV4 密钥对的 S3 网关；两种方式存储的对象没有任何区别，同一组 S3 凭据也仍可用于 rclone、boto3 和任何其他 S3 客户端。

验证情况

此服务中的每个工具在发布前都会针对生产环境进行端到端测试：先生成新的试用账号，再通过直连传输执行加密上传 / 字节精确下载 / 列表 / 删除（test/e2e_prod.mjs 会标识自身，因此不会计入转化漏斗测量），并验证注册服务的带标签错误透传。单元测试会使用模拟协调器和提供方服务器测试传输功能（npm test）。

许可证

从 0.6.2 版起采用 PolyForm Shield 1.0.0（见 LICENSE）。简单来说：你可以出于任何目的使用、阅读、审计、修改和再分发此服务，但不得据此构建与 Obsideo 竞争的产品或服务。这样既能让客户端接受审计（这是产品所依赖的），又不会把成果交给竞争对手。0.6.1 及更早版本仍按已发布时采用的 MIT 许可证授权。存储提供方节点（obsideo-provider）始终采用 MIT 许可证。

隐私政策

此扩展完全在你的机器上运行。凭据、账号签名密钥和任何客户端加密密钥都保存在本地的 ~/.obsideo/mcp.json 中，绝不会发送给 Obsideo 或托管在 Obsideo 上。不会收集来自 AI 助手的对话内容；只有你发起的工具调用（例如上传）会发送到存储服务。

完整政策：https://obsideo.io/privacy/