Beecargo

Beecargo MCP

用于 Beecargo 文件托管 API 的 Model Context Protocol 服务。

便携式市场打包（Agent Plugins 1.0 + Cursor 清单）位于 ../agent-plugin。

最快捷方式（Agent）

无需登录人工控制面板，即可发布永久有效的分享链接：

1. 添加托管 MCP，不带任何标头：https://mcp.beecargo.net/mcp（完整工具；参见 examples/cursor-http.mcp.json）。如果 /mcp 需要身份验证，请使用 https://mcp.beecargo.net/mcp/guest 获取仅用于引导的工具。
2. 调用 beecargo_register_agent → 完成简短的 PoW，获取引导用 bc_*（10GB / 100rpm；会话将采用此密钥）。
3. 调用 beecargo_upload，传入公开的 HTTPS url → 交付 https://beecargo.net/d/{shortId}（始终使用完整分享 URL）。多文件交付：在第一个文件上设置 openShare: true，之后上传的文件设置 shareShortId（共用同一链接，只需解锁一次）。
4. 可选：对 fileId 或 Shipment shortId 调用 beecargo_update_share_settings，设置 protect: true（以及 handoffMessage）→ 通过私密渠道返回 unlockCode 和 handoffUrl（/h/…）。

对于生产环境中的 Agent（包含 100GB 并发存储 / 1000rpm / 高 remote/hr）：通过控制面板 POST /api-keys/agent（需要 Pro）或 operator POST /agent/api-keys 创建 Pro 层级密钥。

临时上传可跳过注册：beecargo_upload 支持匿名使用（限制更严格；请保存 deletionToken）。

工具

工具	身份验证	描述
beecargo_register_agent	无	自行铸造引导用 bc_*（PoW + 速率限制）
beecargo_upload	可选	URL、小型 base64 或本地路径（stdio）；可通过 openShare / shareShortId 创建可扩展的多文件分享
beecargo_upload_status	可选	轮询异步 URL 上传任务
beecargo_create_checkout	无	铸造 Premium Stripe 结账链接（建议：先试用 2 天，再按周付费）
beecargo_purchase_checkout	可选	为定价分享创建付款链接（shortId / fileId / bundleId）
beecargo_purchase_claim	无	付款后：将 sessionId 换为 purchaseToken，用于 beecargo_get_download_url
beecargo_claim_file	API 密钥	使用 claimToken 认领匿名上传
beecargo_search_tools	无	按关键词搜索工具
beecargo_update_share_settings	API 密钥	可见性、priceCents / currency、直接下载、保留期限、protect / handoffMessage（fileId 或 shortId）
beecargo_connect	控制面板密钥 / OAuth	卖家 Stripe Connect（action：status | onboard | login）
beecargo_folders	API 密钥	创建或列出文件夹（action：create | list）
beecargo_get_download_url	无	签名下载 URL（需要时使用 unlockCode / unlockToken / handoffToken / purchaseToken）
beecargo_file_info	可选	按短代码获取元数据（unlockRequired）
beecargo_list_files	必需	列出拥有的文件（includeFolders；可选的 runId 用于流水线清单）
beecargo_delete_file	密钥或删除令牌	删除文件

高级

工具	认证	描述
beecargo_create_upload_delegation	API key	为不得持有 bc_* 的工作进程生成短期有效的 uploadUrl + delegationToken。常规 Agent 上传请优先使用 beecargo_upload。

详细指南：上传、上传状态、运行产物、上传委托、文件夹、分享设置、卖家收款以及购买定价分享。

Stdio（本地）

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

可选：在环境变量中设置 BEECARGO_API_KEY=bc_…。执行 beecargo_register_agent 后，stdio 会话会自动采用新密钥。

请参阅 examples/cursor-stdio.mcp.json。

HTTP（托管）

https://mcp.beecargo.net/mcp（通过认证后可使用全部工具）。访客初始化：https://mcp.beecargo.net/mcp/guest。请参阅 examples/cursor-http.mcp.json。

现有密钥：examples/cursor-http-with-key.mcp.json。

环境变量：请参阅 .env.example。重点说明：

• BEECARGO_API_URL：默认值为 https://api.beecargo.net
• BEECARGO_API_FETCH_TIMEOUT_MS：大型同步远程服务请调高此值（默认建议值：300000）
• BEECARGO_MCP_REQUIRE_AUTH：设为 true，要求 /mcp 使用传输层 bearer 或 bc_* 认证（默认：开放初始化，但有速率限制）
• BEECARGO_MCP_BEARER_TOKEN：当 REQUIRE_AUTH=true 时可选的共享传输密钥
• BEECARGO_MERCHANT_OAUTH_ENABLED：发布 OAuth 资源元数据并启用 Connect with Beecargo（要求 API 和 MCP 上的 INTERNAL_API_KEY 相匹配）

官方 MCP 注册表

server.json 是 io.github.Beecargo/mcp 的官方 MCP 注册表清单（架构版本 2025-12-11）。托管远程服务为 https://mcp.beecargo.net/mcp。此主机以及 https://beecargo.net 上的 /.well-known/mcp/server.json 也提供用于发现的副本。

此文件并不表示该服务已列入注册表。

CLI（本地脚本）

请使用专用软件包 @beecargo/cli：

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

在 monorepo 中运行：pnpm cli upload ./artifact.zip。发布标志（--ttl、--protect，……）与 MCP beecargo_upload 一致。share --price-cents / download --purchase-token 与 MCP 的 share-settings 和 retrieve 一致。

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

与 lomi MCP 的功能对照

lomi	Beecargo
由 OpenAPI 生成的工具	手写文件工具（范围更小）
lomi_search_tools	beecargo_search_tools
无请求头 HTTP 连接	相同（默认）；可选 BEECARGO_MCP_REQUIRE_AUTH
x-lomi-api-key + OAuth	x-beecargo-api-key / Bearer bc_* + 匿名
GET/POST/DELETE /mcp	相同
/health、/ready	相同
REST 重试 + 超时	BEECARGO_API_FETCH_* 环境变量
工具结果	{ ok, status, body } + 分享链接提示

发布

作用域为 @beecargo。首次发布需手动使用 --otp。之后，在 npm 包上将 Trusted Publisher 设置为 GitHub Beecargo/mcp 工作流 publish.yml。然后更新 package.json 中的补丁版本，并推送 main。

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