fileshareforagents

Name: fileshareforagents
Author: fileshareforagents.online

本地服务

fileshareforagents.online文件与存储04 周前更新

代码仓库访问官网

关于 fileshareforagents

fileshareforagents 是面向 AI Agent 的 MCP 文件存储与分享服务，支持免费公开存储，以及通过额度或 x402 USDC 付费的私有存储。

主要功能

01公开存储最多 7 天
02私有存储最多 365 天
03取回并查看已存内容
04通过签名链接或密码分享
05使用额度或 x402 USDC 付款

适用场景

01向他人分享 Agent 生成的文件
02暂存私有数据以供日后取回
03通过限时链接分发文件
04延长保存期或增加读取次数

MCP 相关

它通过 stdio 在本地运行，向 MCP 客户端提供存储、取回、分享、账户和付款工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "online-fileshareforagents": {
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>",
        "FILESHARE_NETWORK": "<FILESHARE_NETWORK>"
      }
    }
  }
}

启动命令npx -y fileshareforagents-mcp

需要配置的环境变量

FILESHARE_API_KEY密钥Account key (fsa_...) from https://fileshareforagents.online/dashboard. Each paid call spends one prepaid credit; no wallet needed. Optional.

WALLET_KEY密钥Private key (0x + 64 hex) of a wallet holding USDC on the chosen network. Optional: without it the free tools work and paid tools explain what to set.

FILESHARE_NETWORKtestnet (default, Base Sepolia with free test USDC) or mainnet (Base, real USDC).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmfileshareforagents-mcp0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

fileshareforagents-mcp

适用于 fileshareforagents.online 的 MCP 服务：为 AI Agent 提供存储和文件共享。公开项目（最长 7 天）免费。私有项目、更长的保留期限、扩展和读取包均为付费调用，每次 1 美分。付款方式有两种：

预付额度，无需钱包。 在 https://fileshareforagents.online/login 登录并购买额度（注册时赠送 10 个），在控制面板中创建 API 密钥，并将其设为 FILESHARE_API_KEY。每次付费调用消耗 1 个额度。
通过 x402 使用 USDC。 将 WALLET_KEY 设为一个在 Base 上持有 USDC 的钱包密钥；服务会为每次调用签署一笔 0.01 美元的付款。密钥不会离开进程，也不会发送给服务。如果两种方式都已配置，会优先使用额度，额度用完后再使用钱包。

该服务在本地与 Agent 一起运行（stdio）。

安装

Claude Desktop、Claude Code、Cursor、Windsurf 和大多数 MCP 客户端都接受类似这样的配置：

{
  "mcpServers": {
    "fileshare": {
      "command": "npx",
      "args": ["-y", "fileshareforagents-mcp"],
      "env": {
        "FILESHARE_API_KEY": "fsa_<key from the dashboard>",
        "FILESHARE_NETWORK": "mainnet"
      }
    }
  }
}

Claude Code，一行命令：

claude mcp add fileshare -e FILESHARE_API_KEY=fsa_... -e FILESHARE_NETWORK=mainnet -- npx -y fileshareforagents-mcp

改用钱包付款：将 FILESHARE_API_KEY 替换为 WALLET_KEY=0x...（一个在所选网络上持有 USDC 的钱包私钥）。

默认从 testnet 开始：在 Base Sepolia 上通过 faucet.circle.com 获取免费的测试 USDC，无需承担真实资金风险。要切换到真实资金，请设置 FILESHARE_NETWORK=mainnet，并使用一个在 Base 上持有 USDC 的钱包。钱包不需要 ETH；付款服务方会支付 gas 费用。

不设置 WALLET_KEY 时，免费工具仍可使用，付费工具会说明需要设置什么。

工具

工具	费用	功能
`store_public`	免费	创建最长保留 7 天的公开项目：文本、JSON、base64 字节或本地文件。任何拥有 `links.public` 的人都可以打开。
`store`	1¢	创建保留 1 至 365 天的私有项目：文本、JSON、base64 字节或本地文件（`file_path`）。包含 100 次读取。返回 `id` 和一次性 `secret`。
`retrieve`	免费（1 次读取）	取回内容。文本和 JSON 会内嵌返回，二进制内容以 base64 返回或保存到 `save_to`。
`status`	免费	过期时间、剩余读取次数、大小、类型、密码状态。
`extend`	1¢	延长过期时间，最多延至从现在起 365 天。
`buy_reads`	1¢	增加 1000 次读取。无需密钥，因此任何人都可以为收到的项目充值。
`share_link`	免费	生成带签名、限时的 URL，任何人都可以打开，无需输入密码。URL 即凭证。
`revoke_links`	免费	使此前签发的所有共享链接失效。
`set_password`	免费	为项目的公开地址设置密码（12 至 128 个字符）。浏览器会显示表单，Agent 发送 `x-password`。
`remove_password`	免费	公开地址将停止提供内容；已签名的链接仍然有效。
`delete`	免费	永久删除，不退款。
`pricing`	免费	价格、限制、允许的内容类型、网络。
`wallet_status`	免费	付款钱包的地址和 USDC 余额，以及充值方式。
`account`	免费	`FILESHARE_API_KEY` 所属账户的额度、文件和存储情况。
`buy_credits`	N¢	通过一次 USDC 付款为该账户购买 N 个额度（需要同时提供密钥和钱包）。
`feedback`	免费	将功能需求、错误或滥用举报直接发送给运营方。

允许的内容：JSON、文本、Markdown、CSV、HTML、SVG、PDF、PNG、JPEG、WebP、GIF，最大 25 MB。

向他人交付内容的两种方式

使用带有 expires_in 秒数的 share_link。发送 URL 即可，无需其他操作；但任何持有该 URL 的人都能在其过期前读取内容。
使用 set_password，然后通过不同渠道发送返回的 public_url 和密码。每次打开该地址时都会要求输入密码。

每次打开都会计为一次读取；如果有很多人要打开，先使用 buy_reads 购买读取次数。

环境

变量	默认值	含义
`FILESHARE_API_KEY`	unset	来自控制面板的 `fsa_…` 账户密钥。付费工具每次调用消耗 1 个额度；无需钱包。
`WALLET_KEY`	unset	`0x` + 64 个十六进制字符。付费工具通过 x402 每次调用支付 $0.01 USDC。
`FILESHARE_NETWORK`	`testnet`	`testnet`（Base Sepolia）或 `mainnet`（Base）。
`FILESHARE_API`	按网络而定	覆盖 API 源地址。
`FILESHARE_SHARE`	按网络而定	覆盖分享域名源地址。

注意事项

内容到期后会被删除且无法恢复。这是一个临时投递箱，不是保险库。
请保留 store 返回的 secret；它只会显示一次。持有它的人可以控制该项目。
服务条款：https://fileshareforagents.online/terms。机器可读文档： https://fileshareforagents.online/llms.txt。
结算失败不会收费；服务会重试一次，否则会返回服务错误，其中包含你可以在 feedback 中引用的 request_id。

采用 MIT 许可证。

支持 Markdown

登录后评论