B2云存储MCP服务器

一个提供与Backblaze B2云存储无缝集成的MCP服务器,支持桶管理、文件操作和大文件处理等功能。

  • by BraveRam
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BraveRam/backblaze-mcp

使用说明

Backblaze B2 MCP服务器

A. 模型上下文协议 (MCP)服务器,提供与Backblaze B2云存储的无缝集成。作为包装物围绕 后窗-b2 npm包,此服务器使Claude Desktop、VS Code和Cursor等MCP客户端能够与您的B2存储桶和文件进行交互。

特性

  • 水桶管理 -创建、删除、列出和更新bucket
  • 文件操作 -上传、列出、隐藏和删除文件
  • 大文件支持 -大于100MB的文件的多部分上传
  • 密钥管理 -管理应用程序密钥和权限
  • 简单设置 -只需在MCP配置中配置您的B2凭据

配置

获取B2证书

  1. 注册于 回火B2
  2. 首选 应用程序密钥 在您的帐户中
  3. 创建新的应用程序密钥
  4. 复制 密钥ID 和 applicationKey

MCP客户端设置

将此配置添加到MCP客户端:

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "backblaze-b2": {
      "command": "npx",
      "args": ["backblaze-mcp"],
      "env": {
        "B2_APPLICATION_KEY_ID": "your_key_id_here",
        "B2_APPLICATION_KEY": "your_application_key_here"
      }
    }
  }
}

VS代码/光标 (.vscode/mcp.json):

{
  "servers": {
    "backblaze-b2": {
      "command": "npx",
      "args": ["backblaze-mcp"],
      "env": {
        "B2_APPLICATION_KEY_ID": "your_key_id_here",
        "B2_APPLICATION_KEY": "your_application_key_here"
      }
    }
  }
}

可用工具

水桶管理(5个工具)

  • createBucket -创建新bucket
  • deleteBucket -删除bucket
  • listBuckets -列出所有桶
  • getBucket -获取存储桶信息
  • updateBucket -更改存储桶类型(公共/私有)

文件操作(7个工具)

  • getUploadUrl -获取上传URL
  • uploadFile -上传文件(base64编码)
  • listFileNames -列出存储桶中的文件
  • listFileVersions -列出所有文件版本
  • hideFile -在列表中隐藏文件
  • getFileInfo -获取文件元数据
  • deleteFileVersion -删除文件版本
  • getDownloadAuthorization -获取下载认证令牌

大文件操作(5个工具)

对于大于100MB的文件:

  • startLargeFile -开始大文件上传
  • getUploadPartUrl -获取零件上传URL
  • uploadPart -上传文件部分
  • listParts -列出上传的零件
  • finishLargeFile -完成上传
  • cancelLargeFile -取消上传

密钥管理(3个工具)

  • createKey -创建应用程序密钥
  • deleteKey -删除密钥
  • listKeys -列出所有密钥

使用示例

上传文件

1. Call getUploadUrl with your bucketId
2. Encode your file to base64
3. Call uploadFile with the URL, token, filename, and base64 data

大文件上传

1. Call startLargeFile to get a fileId
2. Split file into parts and upload each with uploadPart
3. Call finishLargeFile with SHA1 hashes of all parts

发展

从源代码构建

git clone https://github.com/braveram/backblaze-mcp.git
cd backblaze-mcp
npm install
npm run build

二进制数据

文件上传使用base64编码:

  • 调用前将文件编码为base64 uploadFile 或 uploadPart
  • 服务器处理B2的二进制转换

故障排除

服务器无法启动

  • 检查一下 B2_APPLICATION_KEY_ID 和 B2_APPLICATION_KEY 在MCP配置中设置
  • 验证B2控制台中的凭据是否有效

上传失败

  • 确保数据正确进行base64编码
  • 检查存储桶权限
  • 对大于100MB的文件使用大文件操作

构建于

许可证

麻省理工学院