Beecargo

io.github.Beecargo由 GitHub 帳號 Beecargo 發布v0.1.0更新於 Oct 24, 2026

Publish a file from an agent and get a durable beecargo.net/d/{shortId} share link.

已驗證Streamable HTTP可網頁執行檔案與儲存商業與電商

概覽

AI 產生的概覽

Beecargo 讓助理把檔案發佈到 Beecargo 託管服務，並取回持久的分享連結，還可管理資料夾、付費分享與 Stripe 結帳。

可以做什麼
  • 註冊代理並在完成工作量證明後取得引導用 API 金鑰
  • 以公開 URL、小型 base64 或本機路徑上傳檔案，並輪詢非同步上傳工作
  • 管理分享設定：可見性、價格、保留期限、解鎖保護與交接訊息
  • 列出、檢視與刪除自有檔案，建立或列出資料夾
  • 取得簽章下載連結、認領匿名上傳，並建立或認領付費分享的結帳
  • 依關鍵字搜尋此伺服器自身的工具
適用情境
當助理需要把產生的檔案或產物以穩定分享連結交給他人或其他代理時適用，也適合透過 Beecargo 販售或限制檔案存取。若只處理本機檔案或已有其他託管服務，則不需要安裝。
執行需求
透過 streamable HTTP 連線 mcp.beecargo.net 遠端端點；清單宣告需要 OAuth，README 另描述訪客引導路徑與匿名上傳。部分工具可選、部分工具必須使用 bc_ 前綴的 API 金鑰，較高額度需要 Pro 金鑰。清單未宣告環境變數或請求標頭。
安裝前請注意
上傳會把資料發佈到第三方託管並產生公開分享連結，需確認分享內容。多個工具涉及付費或金流：建立 Stripe 結帳、為分享定價、認領購買以及賣家 Connect 入駐。註冊、認領與刪除依賴 deletionToken、claimToken、unlockCode 等權杖，需妥善保管。檔案可被刪除、分享設定可被修改，會影響持有連結的人。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Beecargo，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Beecargo%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "beecargo": {
      "type": "http",
      "url": "https://mcp.beecargo.net/mcp"
    }
  }
}

README

Beecargo MCP

Model Context Protocol server for the Beecargo file hosting API.

Portable marketplace packaging (Agent Plugins 1.0 + Cursor manifest) lives in ../agent-plugin.

Fastest path (agents)

Publish a durable share link with no human dashboard login:

  1. Add hosted MCP with no headers: https://mcp.beecargo.net/mcp (full tools; see examples/cursor-http.mcp.json). If /mcp requires auth, use https://mcp.beecargo.net/mcp/guest for bootstrap-only tools.
  2. Call beecargo_register_agent → solves a short PoW, returns bootstrap bc_* (10GB / 100rpm; session adopts the key).
  3. Call beecargo_upload with a public HTTPS url → hand off https://beecargo.net/d/{shortId} (always the full share URL). Multi-file handoff: openShare: true on the first file, then shareShortId on later uploads (same link, one unlock).
  4. Optional: beecargo_update_share_settings with protect: true (+ handoffMessage) on fileId or Shipment shortId → return unlockCode and handoffUrl (/h/…) on a private channel.

For production agents (100GB included concurrent storage / 1000rpm / high remote/hr): mint a Pro-tier key via dashboard POST /api-keys/agent (Pro required) or operator POST /agent/api-keys.

Skip registration for ephemeral uploads: beecargo_upload works anonymously (stricter limits; save deletionToken).

Tools

ToolAuthDescription
beecargo_register_agentNoneSelf-mint bootstrap bc_* (PoW + rate-limited)
beecargo_uploadOptionalURL, small base64, or local path (stdio); openShare / shareShortId for growable multi-file shares
beecargo_upload_statusOptionalPoll async URL upload jobs
beecargo_create_checkoutNoneMint Premium Stripe checkout (recommended: 2-day trial then weekly)
beecargo_purchase_checkoutOptionalMint pay link for a priced share (shortId / fileId / bundleId)
beecargo_purchase_claimNoneAfter pay: sessionId → purchaseToken for beecargo_get_download_url
beecargo_claim_fileAPI keyClaim anonymous upload with claimToken
beecargo_search_toolsNoneKeyword search over tools
beecargo_update_share_settingsAPI keyVisibility, priceCents / currency, direct, retention, protect / handoffMessage (fileId or shortId)
beecargo_connectDashboard key / OAuthSeller Stripe Connect (action: status | onboard | login)
beecargo_foldersAPI keyCreate or list folders (action: create | list)
beecargo_get_download_urlNoneSigned download URL (unlockCode / unlockToken / handoffToken / purchaseToken when needed)
beecargo_file_infoOptionalMetadata by short codes (unlockRequired)
beecargo_list_filesRequiredList owned files (includeFolders; optional runId for pipeline manifests)
beecargo_delete_fileKey or deletion tokenDelete file

Advanced

ToolAuthDescription
beecargo_create_upload_delegationAPI keyMint a short-lived uploadUrl + delegationToken for a worker that must not hold bc_*. Prefer beecargo_upload for normal agent uploads.

Detailed guides: upload, upload status, run artifacts, upload delegation, folders, share settings, seller payouts, and buy a priced share.

Stdio (local)

bash
cd apps/mcp && pnpm build && pnpm start

Optional: BEECARGO_API_KEY=bc_… in env. After beecargo_register_agent, the stdio session adopts the new key automatically.

See examples/cursor-stdio.mcp.json.

HTTP (hosted)

https://mcp.beecargo.net/mcp (full tools when authenticated). Guest bootstrap: https://mcp.beecargo.net/mcp/guest. See examples/cursor-http.mcp.json.

Existing key: examples/cursor-http-with-key.mcp.json.

Env: see .env.example. Highlights:

  • BEECARGO_API_URL: default https://api.beecargo.net
  • BEECARGO_API_FETCH_TIMEOUT_MS: raise for large sync remotes (default guidance: 300000)
  • BEECARGO_MCP_REQUIRE_AUTH: set true to require transport bearer or bc_* on /mcp (default: open bootstrap, rate-limited)
  • BEECARGO_MCP_BEARER_TOKEN: optional shared transport secret when REQUIRE_AUTH=true
  • BEECARGO_MERCHANT_OAUTH_ENABLED: publish OAuth resource metadata and enable Connect with Beecargo (requires matching INTERNAL_API_KEY on API + MCP)

Official MCP Registry

server.json is the Official MCP Registry manifest for io.github.Beecargo/mcp (schema 2025-12-11). The hosted remote is https://mcp.beecargo.net/mcp. Discovery copies also live at /.well-known/mcp/server.json on this host and on https://beecargo.net.

This file does not mean the server is already listed in the registry.

CLI (local scripts)

Use the dedicated package @beecargo/cli:

bash
npx --yes github:Beecargo/cli upload ./artifact.zip --jsonnpx --yes github:Beecargo/cli remote https://example.com/file.bin --async --jsonnpx --yes github:Beecargo/cli share FILE_ID --price-cents 500 --key YOUR_BC_KEYnpx --yes github:Beecargo/cli download FILE_ID ./out.bin --purchase-token TOKEN

From the monorepo: pnpm cli upload ./artifact.zip. Publish flags (--ttl, --protect, …) match MCP beecargo_upload. share --price-cents / download --purchase-token match MCP share-settings and retrieve.

bash
pnpm smoke:http   # MCP transport (no API)BEECARGO_API_URL=http://localhost:3001 pnpm smoke:api   # live upload against API

Parity with lomi MCP

lomiBeecargo
OpenAPI-generated toolsHand-written file tools (smaller surface)
lomi_search_toolsbeecargo_search_tools
Zero-header HTTP connectSame (default); optional BEECARGO_MCP_REQUIRE_AUTH
x-lomi-api-key + OAuthx-beecargo-api-key / Bearer bc_* + anonymous
GET/POST/DELETE /mcpSame
/health, /readySame
Retries + timeout on RESTBEECARGO_API_FETCH_* env
Tool results{ ok, status, body } + share link hints

Publish

Scope is @beecargo. First publish is manual with --otp. After that, set Trusted Publisher on the npm package to GitHub Beecargo/mcp workflow publish.yml. Then bump the patch in package.json and push main.

bash
pnpm typecheck && pnpm publish --access public --otp=XXXXXX

來源：README.md，提交 be9459a

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分