mcpField
B
bkend-storage

bkend-storage

github.com/ww-w-aiCloud & DevOps60643 installsUpdated 4w ago
Repository

About bkend-storage

bkend-storage is a file-storage guide for developers using bkend.ai. It describes presigned URLs, visibility levels, REST endpoints, and multipart upload flows for managing files.

Key features

  1. 01Single and multiple file upload flows
  2. 02Multipart uploads for large files
  3. 03Four file visibility levels
  4. 04File management REST API
  5. 05Find examples through document search

Use cases

  1. 01Upload ordinary files
  2. 02Handle large files in parts
  3. 03Serve files with access controls
  4. 04Find code examples for file operations

MCP support

The guide notes that bkend MCP has no dedicated storage tools. MCP clients can search storage documentation and use it to generate REST API code for file operations.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill bkend-storage

After installing, type/bkend-storagein Claude Code to confirm it loaded.

Details

From the project README

bkend.ai Storage Guide

Upload Methods

MethodUse CaseProcess
SingleNormal filesPresigned URL -> PUT upload -> Register metadata
MultipleMultiple filesRepeat single upload
MultipartLarge filesInitialize -> Part URLs -> Complete

Presigned URL

  • Validity: 15 minutes
  • PUT method with file binary
  • Content-Type header required

File Visibility (4 levels)

LevelAccessURL Type
publicAnyoneCDN URL (no expiry)
privateOwner onlyPresigned URL (1 hour)
protectedAuthenticated usersPresigned URL (1 hour)
sharedSpecified targetsPresigned URL (1 hour)

Size Limits

CategoryMax Size
Images10 MB
Videos100 MB
Documents20 MB

Storage Categories

images, documents, media, attachments

MCP Storage Workflow

bkend MCP does NOT have dedicated storage tools. Use this workflow:

  1. Search docs: search_docs with query "file upload presigned url"
  2. Get examples: search_docs with query "file upload code examples"
  3. Generate code: AI generates REST API code for file operations
Searchable Storage Docs
Doc IDContent
7_code_examples_dataCRUD + file upload code examples

REST Storage API

MethodEndpointDescription
POST/v1/files/presigned-urlGenerate presigned URL
POST/v1/filesRegister metadata (complete upload)
GET/v1/filesFile list
GET/v1/files/:fileIdFile detail
PATCH/v1/files/:fileIdUpdate metadata
DELETE/v1/files/:fileIdDelete file
POST/v1/files/:fileId/download-urlGenerate download URL

Multipart Upload (Large Files)

MethodEndpointDescription
POST/v1/files/multipart/initInitialize multipart upload
POST/v1/files/multipart/presigned-urlGet part upload URL
POST/v1/files/multipart/completeComplete multipart upload
POST/v1/files/multipart/abortAbort multipart upload

Upload Flow (Single File)

1. POST /v1/files/presigned-url -> { url, fileId }
2. PUT {url} with file binary + Content-Type header
3. POST /v1/files with { fileId, filename, contentType, size, visibility }

Multipart Upload Flow (Large File)

1. POST /v1/files/multipart/init -> { uploadId }
2. POST /v1/files/multipart/presigned-url -> [{ partNumber, url }]
3. PUT each part URL with file chunk
4. POST /v1/files/multipart/complete -> { file }

Official Documentation (Live Reference)

For the latest storage documentation, use WebFetch:

Comments

Markdown supported