Bitatlas

BitAtlas MCP 服务 🤖

为 AI Agent 提供零知识云盘持久化存储。

此模型上下文协议（MCP）服务允许 AI Agent 安全地与 BitAtlas 保险库交互。所有文件都在客户端加密，这意味着服务永远无法看到明文数据。

功能

• 搜索并列出保险库：Agent 可以浏览加密的文件元数据。
• 安全获取：Agent 可以获取加密文件块和解密元数据。
• 零知识：Agent 使用用户提供的主密钥在本地解密。
• 向人类交付文件：bitatlas_share_file 会生成一个公开链接，主机无法读取文件——解密密钥位于 URL 片段中，永远不会传到 BitAtlas。这是“Agent 生成产物 → 人类打开链接”这一典型交付方式，同时无需牺牲零知识保护。

工具

工具	用途
bitatlas_vault_status	查看保险库运行状况、文件数量和存储用量
bitatlas_list_files	列出文件元数据（按文件夹／类别／搜索词筛选）
bitatlas_search	按名称搜索文件
bitatlas_get_file	下载并解密文件内容
bitatlas_upload_file	在客户端加密本地文件并上传
bitatlas_delete_file	删除文件
bitatlas_create_folder	创建文件夹
bitatlas_share_file	创建公开的零知识分享链接（/s/<id>#k=…），以便向人类交付文件。⚠️ 任何拥有此链接的人都能读取文件。
bitatlas_list_shares	列出分享链接及其有效期、下载次数和状态
bitatlas_revoke_share	撤销分享链接（阻止后续下载）

安装

适用于 AI Agent（Claude Desktop、OpenClaw 等）

将以下内容添加到 MCP 设置中：

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": ["-y", "@bitatlas/mcp-server"],
      "env": {
        "BITATLAS_API_KEY": "your-api-key",
        "BITATLAS_MASTER_KEY": "your-derived-master-key"
      }
    }
  }
}

x402 钱包模式（无需账户）

Agent 无需使用 API 密钥，可以通过带有 Base 上 USDC 的加密货币钱包按请求付费：

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": ["-y", "@bitatlas/mcp-server"],
      "env": {
        "BITATLAS_WALLET_PRIVATE_KEY": "0xabc...",
        "BITATLAS_MASTER_KEY": "your-64-hex-char-master-key"
      }
    }
  }
}

无需注册，也无需 API 密钥。Agent 按请求使用 USDC 付费，即可获得完整的保险库访问权限。文件包含 30 天存储空间，并可续期。

**优先级：**如果同时设置了 BITATLAS_API_KEY 和 BITATLAS_WALLET_PRIVATE_KEY，则优先使用 API 密钥（在配额范围内免费）。

环境变量

变量	必需	描述
BITATLAS_API_KEY	API 密钥或钱包二选一	从 bitatlas.com 获取的个人访问令牌
BITATLAS_WALLET_PRIVATE_KEY	API 密钥或钱包二选一	用于 x402 付款的 EVM 私钥
BITATLAS_MASTER_KEY	加密／解密时必需	64 位十六进制字符串（256 位主密钥）
BITATLAS_API_URL	否	默认为 https://api.bitatlas.com
BITATLAS_WEB_URL	否	用于生成分享链接的 Web 源地址。默认为 https://www.bitatlas.com

开发

npm install
npm run start

许可证

MIT