mcp-exports

内部 MCP 服务器共用的单次下载主机。

https://exports.example.com · 主机端口 8114 · 无需客户登录

MCP server  --POST /put  (service token)-->  mcp-exports  -->  download URL
customer    --GET  /d/{token} (no auth)  -->  mcp-exports  -->  the file, once

为什么存在

一个内联返回一周通话记录的工具要消耗 ~530,000 tokens；同样的数据导出成 CSV 只有 1 MB，1.6 秒就能生成。所以导出功能返回的是一个链接。第一个版本设想让导出服务自身直接提供这个链接，结果在三个方面失效：

1. MCP 主机位于 Anthropic 专属的 IP 白名单之后，而真正下载文件的是客户在任意地址上的浏览器。一个独立的主机名才能让两套访问策略互不干扰，而不是在早已承载了 MCP 所需流式设置的代理配置里硬挖一条绕过路径。

2. MCP 容器每次 push 都会重新部署，内存中的存储也随之销毁——对话进行中间，已发出的链接也会失效。

3. 存储归属于某一个进程，第二个 worker 就会随机返回 404。

Related MCP server: agent-secret

安全模型：直说

下载 URL 就是一种能力（capability）：谁拿到它就能拿到文件，不需要登录。这与我们已经在发放的 NetSapiens 录音 URL、Odoo portal PDF 是同一个取舍，也正是这一点能否让链接在聊天窗口里被点击后直接工作的原因。它不是身份凭证，弱点也真实存在——URL 会被转发、被代理记入日志，或者在聊天记录里永久留存。

所以整个设计都依赖那些真正有用的措施：

上传是认证的——即一台 server 一台账号对应的 bearer token：发布文件，从来不是整个互联网的家伙都可以。而服务在允许列表为空时拒绝再次启动。

API

POST /put?filename=x.csv&sensitivity=data|financial&customer=Acme%20Movers
     &ttl=3600&max_downloads=1
     Authorization: Bearer <server token>
  -> 201 {download_url, filename, size, expires_in_seconds, expires_at,
          max_downloads, single_use}

GET  /d/{token}   -> 200 the file (then it is gone), or 404
GET  /healthz     -> counters + bytes held

ttl 是受限制，不是照做——请求一周，给的是 GS_UNSPECIFIED MCP_EXPORTS_TTL_MAX，并让响应用返回实际给到的数值。

用于 MCP server 使用

把 client/export_client.py 复制到 server，再设置 MCP_EXPORTS_URL 以及 MCP_EXPORTS_TOKEN。

ExportClient.from_env() 在没有配置时返回 None，这样你的 server 才能只在 host 真接好了的机器里提供导出工具，而不是真用一个长期会报错的 tool。

当服务出错会抛出异常而不是降级到 inline rows：如果 host 不在的时候不可能存在一种安全降级，因为返回内联行正是导出想避免的那个事故。

部署

Portainer → Stack → Repository，refs/heads/main，端口 8114。给每个 MCP server 各搞一份 token：

python -c "import secrets; print(secrets.token_urlsafe(32))"

NPM：exports.example.com → 10.0.0.11:8114，无 Access List（这正是我们留下这条记录的根本效果），Websockets 关闭，其他超时默认。

测试

python -m pytest tests -q

47 个测试，不依赖网络。覆盖在这些安全细节的特意性：单次使用，文件真的删除；任何错误 token 形状丑化了无法区分；文件名不会导致路径逃逸或 header 注入；金融型的 TTL 确实更短；以及 Dockerfile 在放弃 root 前进行中就先行对挂载点执行 chown——否则命名卷会以 root 选项来进入系统，然后每个上传都回报 EACCES。