Obsideo MCP 服务器是一个为 AI 智能体提供加密对象存储的 MCP 服务，基于 Obsideo 平台。它让任何支持 MCP 的智能体（如 Claude Desktop、Claude Code、Cursor、Cline 等）获得持久化存储能力，数据在上传前于本机加密，并可通过密码学持有证明独立验证存储方是否仍持有数据。
用途：为智能体提供应用文件存储、自动化备份（数据库、快照、状态）、跨会话和跨机器的智能体产物与记忆存储，以及可证明的异地副本。不适用于 CDN、可查询数据库或亚毫秒级存储场景。
主要能力：
- 提供 put、get、ls、rm 等对象操作，以及 verify 验证工具，共 13 个工具。
- 默认客户端加密（AES-256-GCM），使用本机生成、用户持有的密钥，平台架构上无法读取密文。仅在需要其他工具直接读取存储字节（S3 互操作）时可设置 encrypt: false。
- 每个存储对象被复制到 3 个提供方，并通过分块级默克尔证明持续挑战；提供方仅通过证明才能获得报酬。
- verify 工具直接挑战每个持有对象的提供方，随机选取一个分块，在本机将每个回答与默克尔根比对。对于本服务器上传的对象，使用上传时本地记录的根，因此通过验证意味着提供方确实持有数据，而非与其他方一致。
- 支持 S3 兼容接口，可与 rclone、boto3 及其他 S3 客户端配合使用。
使用方式：
- Claude Desktop：从最新发布版下载 obsideo-mcp.mcpb，在设置 -> 扩展中拖入文件即可，无需 Node 或 npm。
- 其他方式通过 npx：Claude Desktop 配置 claude_desktop_config.json；Claude Code 使用 claude mcp add obsideo -- npx -y obsideo-mcp；Cursor/Cline 在其 MCP 设置中使用相同命令。需要 Node 18 或更高版本。
- Hermes Agent：将 https://obsideo.io/agent-storage 粘贴给 Hermes 并说“set this up”，该页面是智能体执行的运行手册，包含安装、首次存储、首次证明，然后使用邮箱升级到免费 12 GB 层级。安装命令写入 Hermes 自身配置，连接后列出 13 个工具并询问启用哪些（若不想让智能体有删除工具，可排除 rm）。之后在运行会话中执行 /reload-mcp 或启动新会话。工具显示为 mcp_obsideo_put、mcp_obsideo_get、mcp_obsideo_verify 等。手动替代方案：在 Hermes 的 config.yaml 的 mcp_servers: 键下使用相同的 mcpServers 块。
- 首次使用 put/get/ls 会自动创建免费无邮箱试用账户（100 MB，采用工作量证明而非身份验证），无需配置即可使用。自助注册可升级至 12 GB 免费空间，无需信用卡、无验证码、无到期时间。
隐私与密钥管理：
- 服务器完全运行在用户本机，Obsideo 不托管该服务器。凭证、账户签名密钥和加密密钥保存在 ~/.obsideo/ 目录，仅发送给其认证的端点。
- 账户签名密钥在本地生成，仅公钥部分被发送。请保持 ~/.obsideo/signing.pem 私密。重新运行注册会轮换凭证和密钥对且无重叠，因此不要随意重新运行。
- 加密密钥在账户创建时于本机生成并写入 ~/.obsideo/mcp.json。Obsideo 没有副本且无法恢复。若该文件丢失，所有加密对象将永久不可读，无论多少提供方仍持有数据、通过多少证明。复制可防止提供方丢失数据，但不能防止用户丢失密钥。注册后应立即调用 backup_keys 并保存归档到即使丢失本机仍可访问的位置。加密对象目前无法在人与人、机器与机器之间共享，因此一个账户应视为单人使用。
- ~/.obsideo/roots.json 与密钥一同写入，记录每个对象上传时提交的默克尔根。它不含机密，用于让 verify 在不重新上传的情况下证明提供方持有数据。加密每次上传使用新 IV，因此密文无法从明文文件重新计算；该记录为加密对象保留强证明。丢失它会降低证明强度，但不丢失数据。若损坏，服务器会原样移开并在下次结果中说明，而非覆盖。
付费与智能体权限：
- upgrade 工具仅返回链接。由人类打开链接，查看确切月费，支付或关闭标签页；支付后配额提升。现有方案不会从此服务器调整大小：接近层级上限时 Obsideo 会发送同意链接，只有人类点击才会改变账单。
- portal 工具返回 Stripe 门户链接，用于取消、更换卡片和下载发票。取消后所有存储内容保留且可读；账户在付费期结束时回到免费配额。
- 付费方案为每 200 GB 每月 5 美元，通过 Stripe 支付，从升级工具启动并在 Stripe 自己的页面支付。
适用场景：应用文件存储、自动化备份、智能体产物与记忆、可证明的异地副本。
限制：
- 不是 CDN、不是可查询数据库、不是亚毫秒级存储。
- 加密对象目前不支持共享。
- 需要 Node 18 或更高版本（npx 方式）。
- 从 0.7.0 起，put/get/ls/rm 直接与协调器和存储提供方通信，无 S3 网关跳转。早于协调器密钥的配置或 OBSIDEO_TRANSPORT=s3 仍使用 S3 网关和 SigV4 密钥对；存储对象在两种方式间无变化，相同 S3 凭证仍可用于 rclone、boto3 等。
- 许可证：从 0.6.2 版起为 PolyForm Shield 1.0.0，允许使用、阅读、审计、修改和再分发，但不得构建与 Obsideo 竞争的产品或服务。0.6.1 及更早版本仍为 MIT。存储提供方节点 obsideo-provider 保持 MIT。
- 完整集成契约见 obsideo.io/agents.md。
- 隐私政策见 https://obsideo.io/privacy/。
