Filecoin链上云MCP
用于Filecoin Onchain Cloud上分散文件存储的MCP服务器
](https://www.npmjs.com/package/@fil-b/foc-storage-mcp)  ](https://nodejs.org)
@fil-b/foc-storage-mcp 通过模型上下文协议（MCP）为AI代理提供对Filecoin去中心化存储网络的无缝访问。通过自动支付处理、CDN支持和全面的数据集管理持久存储文件。
特性
- 🛠️ 10个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)
注： 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 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美元/天/月（每历元支付：30秒）•最低：0.06美元/月
例子： 1年150吉布≈0.44美元FC（0.44美元）
💡 问你的经纪人： _“6个月内存储500 GiB需要多少钱？”_
工具
在Claude、Cursor或任何MCP客户端中自然提问：
文件操作
uploadFile-使用自动支付上传文件getDatasets-列出所有存储的数据集getDataset-获取数据集详细信息createDataset-创建新的数据集容器
余额和付款
getBalances-检查钱包和存储指标processPayment-存入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依赖错误：
- 清除npm缓存：
npm cache clean --force - 清除npx缓存：
npx clear-npx-cache - 更新npm：
npm install -g npm@latest - 作为最后的手段，使用旧的npm：
npm install -g npm@10
安全
- 切勿提交私钥或
.env文件 - 主网前校准网络测试
- 保持余额>30天（Filecoin热存储要求）
- 定期监控余额
getBalances - 使用硬件钱包进行生产
链接
贡献
欢迎投稿！打开一个问题以进行重大更改。
许可证
MIT© @ 尼奥1
______________________________________________________________________
内置于❤️ @FILBuilders为Filecoin生态系统