Filecoin Onchain Cloud MCP

基于Filecoin Onchain Cloud的去中心化文件存储MCP服务器

@fil-b/foc-storage-mcp 通过模型上下文协议（MCP）为AI代理提供无缝访问Filecoin去中心化存储网络的能力。支持自动支付处理、CDN支持以及全面的数据集管理。

功能

• 🛠️ 10个MCP工具 - 文件上传、管理和定价操作
• 📁 数据集组织 - 高效地分组相关文件
• 💳 自动支付 - 内置USDFC处理，无需支付gas费用
• ⚡ 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天）

注意： Filecoin暖存储需要提前支付30天费用。保持余额超过30天以维持服务。

安装

跳转到： Cursor | Claude Code | Claude Desktop | VS Code | Windsurf | Codex | 其他工具

Cursor

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

Claude Code

添加到 .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

添加到 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"
      }
    }
  }
}

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

Windsurf

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

{
  "m.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"
      }
    }
  }
}

定价

存储： $2.50/TiB/月（按纪元支付：30秒）• 最低：$0.06/月

示例： 150 GiB存储一年 ≈ 0.44 USDFC ($0.44)

💡 向您的代理询问：“存储500 GiB六个月需要多少？”

工具

在Claude、Cursor或其他MCP客户端中自然提问：

文件操作

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

余额与支付

• getBalances - 检查钱包和存储指标
• processPayment - 存入USDFC代币

提供商与定价

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

使用示例

"检查我的存储余额"
"启用CDN上传presentation.pdf"
"存储2 TB一年需要多少？"
"为Q4报告创建一个数据集"
"显示我所有的数据集"

故障排除

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

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

交易失败： 检查FIL用于gas，确认网络设置，确认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文件
• 在主网之前先在Calibration网络上进行测试
• 保持余额大于30天（Filecoin暖存储要求）
• 定期使用getBalances监控余额
• 生产环境中使用硬件钱包

链接

• GitHub
• NPM
• Filecoin 文档
• MCP 协议

贡献

欢迎贡献！对于重大更改，请打开一个issue。

许可证

MIT © @nijoe1

---

由@FILBuilders为Filecoin生态系统打造