AI导哈

去中心化文件存储服务

Filecoin Onchain Cloud MCP 是一个基于Filecoin区块链的去中心化文件存储服务，支持AI代理存储和检索文件，具有自动支付处理、CDN支持和数据集管理功能。

  • by FIL-Builders
  • TypeScript
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 FIL-Builders/foc-storage-mcp

使用说明

Filecoin链上云MCP

用于Filecoin Onchain Cloud上分散文件存储的MCP服务器

@fil-b/foc-storage-mcp 允许AI代理通过模型上下文协议（MCP）在Filecoin的去中心化网络上存储和检索文件，具有自动支付处理、CDN支持和数据集管理功能。

特征

  • 🛠️ 11 MCP工具 -上传、管理、定价和支付存储操作费用
  • 📁 数据集组织 -高效地分组相关文件
  • 💳 自动支付 -内置USDFC处理，无气体许可证
  • ⚡ CDN支持 -快速检索频繁访问的文件
  • 💰 成本估算 -计算成本、解释定价、转换单位
  • 🤖 AI就绪 -专为Claude、Cursor和MCP客户设计

配置

要求：

  • Node.js>=20.10.0(检查版本: node --version)
  • PRIVATE_KEY -您的Filecoin钱包私钥（0x…）

可选：

  • FILECOIN_NETWORK - mainnet （生产）或 calibration （测试，默认）
  • TOTAL_STORAGE_NEEDED_GiB -计算的默认存储容量（默认值：150 GiB）
  • PERSISTENCE_PERIOD_DAYS -数据保留期（默认值：365天）
  • RUNOUT_NOTIFICATION_THRESHOLD_DAYS -余额警告阈值（默认值：45天， 推荐>30)
  • SYNAPSE_SOURCE -向Synapse标识此客户端的源标记（默认值： foc-storage-mcp)

注： Filecoin热存储需要预付30天。保持30天以上的余额以维持服务。

安装

跳转到： 光标 | 克劳德代码 | 克劳德桌面版 | VS Code | 帆板运动 | 法典 | 其他

光标

安装后，更新 PRIVATE_KEY 在您的配置中。 了解更多

克劳德代码

添加 .mcp.json:

{
  "mcpServers": {
    "foc-storage": {
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "FILECOIN_NETWORK": "calibration"
      }
    }
  }
}

了解更多

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "foc-storage": {
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "FILECOIN_NETWORK": "calibration"
      }
    }
  }
}

了解更多

VS Code

创建 .vscode/mcp.json:

{
  "servers": {
    "foc-storage": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "FILECOIN_NETWORK": "calibration"
      }
    }
  }
}

启用：设置→ Chat → MCP.点击“开始” mcp.json （仅代理模式）。 了解更多

帆板运动

编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "foc-storage": {
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "FILECOIN_NETWORK": "calibration"
      }
    }
  }
}

重新启动Windsurf。 了解更多

OpenAI Codex

codex mcp add foc-storage -- npx -y @fil-b/foc-storage-mcp

编辑配置以添加环境变量。验证： codex mcp list. 了解更多

其他工具

大多数MCP工具支持此格式：

{
  "mcpServers": {
    "foc-storage": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fil-b/foc-storage-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "FILECOIN_NETWORK": "calibration"
      }
    }
  }
}

定价

定价从实时Synapse v1价格表中读取。存储按纪元计费 （30秒）使用每TiB每月费率加上每数据集定期服务 非空数据集的费用。上传还可以包括一次性创建数据集和 添加碎片费用，CDN出口是基于使用量的。

💡 问你的经纪人： “6个月内存储500 GiB需要多少钱？”

验证

npm test
npx tsc --noEmit
npm run build:mcp
npm run smoke:mcp:readonly
npm run build

smoke:mcp:readonly 启动内置的stdio服务器并执行只读MCP 用于定价、提供商、余额和数据集的工具。它故意跳过 上传、支付、提款和数据集创建事务；只运行那些 使用有意资助的校准钱包。

工具

在Claude、Cursor或任何MCP客户端中自然提问：

文件操作

  • uploadFile -使用自动支付上传文件
  • getDatasets -列出所有存储的数据集
  • getDataset -获取数据集详细信息
  • createDataset -创建新的数据集容器

余额和付款

  • getBalances -检查钱包和存储指标
  • processPayment -存入USDFC代币
  • processWithdrawal -从您的钱包中提取指定的USDFC金额

供应商和定价

  • getProviders -列出存储提供商
  • estimateStoragePricing -计算成本
  • getStoragePricingInfo -解释定价模型
  • convertStorageSize -转换单位

使用示例

"Check my storage balance"
"Upload presentation.pdf with CDN enabled"
"How much to store 2 TB for 1 year?"
"Create a dataset for Q4 reports"
"Show all my datasets"

故障排除

找不到服务器： 验证 npx --version，检查JSON语法，重新启动IDE

“需要PRIVATE_KEY”： 添加 env 部分，必须以开头 0x

交易失败： 检查FIL的天然气，验证网络设置，确认USDFC余额

“版本无效”或npm依赖错误：

  1. 清除npm缓存： npm cache clean --force
  2. 清除npx缓存： npx clear-npx-cache
  3. 更新npm： npm install -g npm@latest
  4. 作为最后的手段，使用旧的npm： npm install -g npm@10

安全

  • 切勿提交私钥或 .env 文件
  • 主网前校准网络测试
  • 保持余额>30天（Filecoin热存储要求）
  • 定期监控余额 getBalances
  • 使用硬件钱包进行生产

链接

贡献

欢迎投稿！打开一个问题以进行重大更改。

许可证

MIT© @ 尼奥1

内置于❤️ @FILBuilders为Filecoin生态系统

相关 MCP