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 分