Bitatlas

BitAtlas MCP Server 🤖

AI エージェント向けのゼロ知識クラウドドライブ永続化。

この Model Context Protocol（MCP）サーバーにより、AI エージェントは BitAtlas vault を安全に利用できます。すべてのファイルはクライアント側で暗号化されるため、サーバーが平文データを目にすることはありません。

機能

• Vault の検索と一覧表示：エージェントは暗号化されたファイルメタデータを閲覧できます。
• 安全な取得：エージェントは暗号化された blob と復号メタデータを取得できます。
• ゼロ知識：エージェントは、ユーザーから提供されたマスターキーを使用してローカルで復号します。
• ファイルを人間に渡す：bitatlas_share_file は公開リンクを生成します。ホストはファイルを 読み取れません。復号キーは URL フラグメントに含まれ、BitAtlas に届くことはありません。ゼロ知識を維持したまま、「エージェントが成果物を作成 → 人間がリンクを開く」という標準的な受け渡しが可能です。

ツール

ツール	目的
bitatlas_vault_status	Vault の状態、ファイル数、ストレージ使用量
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 エージェント向け（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 ウォレットモード（アカウント不要）

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 キーも不要です。エージェントはリクエストごとに USDC で支払い、Vault にフルアクセスできます。ファイルには 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 文字の 16 進数文字列（256 ビットのマスターキー）
BITATLAS_API_URL	いいえ	デフォルトは https://api.bitatlas.com
BITATLAS_WEB_URL	いいえ	共有リンクの生成に使用する Web オリジン。デフォルトは https://www.bitatlas.com

開発

npm install
npm run start

ライセンス

MIT