foc-storage-mcp

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Uyari
  • network request — Outbound network request in package.json
  • process.env — Environment variable access in src/config/index.ts
  • crypto private key — Private key handling in src/lib/synapse.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Model Context Protocol server that brings Filecoin's decentralized storage directly to your AI assistant. Store and manage your files on the Filecoin onchain cloud through natural conversation with any MCP-compatible AI tool.

README.md

Filecoin Onchain Cloud MCP

⚠️ DEPRECATED — This repository is archived and no longer maintained.

👉 Use foc-cli instead.

foc-cli is the official successor. It includes everything this MCP server did, plus a full CLI, AI agent skills, and richer tooling for Filecoin Onchain Cloud.

Status: Archived
Replacement: foc-cli
License: MIT


📣 Migration Notice

@fil-b/foc-storage-mcp has been replaced by foc-cli — a single package that provides:

  • MCP server — same agent-facing tools you had here, kept in sync with the SDK
  • CLI — direct terminal access (npx foc-cli upload ./file.pdf)
  • AI agent skills via skills.sh — works with Claude Code, Cursor, Copilot, Codex, Windsurf, and 20+ AI tools
  • Active maintenance — built on the latest Synapse SDK
  • Expanded features — multi-upload, redundant copies, structured output (--json, --format yaml), schema introspection, and more

If you were using this MCP server, switching takes one command.

Quick migration

Before (this archived repo):

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

After (foc-cli):

# Auto-detect your agent and install
npx foc-cli mcp add

# Or target a specific agent
npx foc-cli mcp add --agent claude-code

Or install as an AI agent skill (recommended for Claude Code, Cursor, and similar):

npx skills add FIL-Builders/foc-cli

See the foc-cli README for full setup and command reference.

Tool mapping

Every tool from this MCP server has an equivalent in foc-cli:

Old MCP tool (@fil-b/foc-storage-mcp) New in foc-cli
uploadFile foc-cli upload <path> / MCP upload tool
getDatasets foc-cli dataset list
getDataset foc-cli dataset details -d <id>
createDataset foc-cli dataset create
getBalances foc-cli wallet balance / wallet summary
processPayment foc-cli wallet deposit <amount>
getProviders foc-cli provider list
estimateStoragePricing foc-cli wallet costs --extraBytes <n> --extraRunway <months>
getStoragePricingInfo foc-cli docs --prompt "pricing"
convertStorageSize Handled natively by CLI flags

About this archive

The sections below describe @fil-b/foc-storage-mcp as it was when this repository was active. They are preserved for reference only — no further updates, bug fixes, or security patches will be issued. Please migrate to foc-cli.

Click to expand original README

What it was

@fil-b/foc-storage-mcp provided AI agents with access to Filecoin's decentralized storage network through the Model Context Protocol (MCP). It supported file upload with automatic USDFC payment handling, dataset organization, CDN-backed retrieval, and cost estimation.

Original tools (10)

File operations

  • uploadFile — Upload files with auto-payment
  • getDatasets — List all stored datasets
  • getDataset — Get dataset details
  • createDataset — Create new dataset container

Balance & payments

  • getBalances — Check wallet and storage metrics
  • processPayment — Deposit USDFC tokens

Providers & pricing

  • getProviders — List storage providers
  • estimateStoragePricing — Calculate costs
  • getStoragePricingInfo — Explain pricing models
  • convertStorageSize — Convert units

Original configuration

Requirements: Node.js >= 20.10.0, PRIVATE_KEY env var (Filecoin wallet, 0x...)

Optional env vars:

  • FILECOIN_NETWORKmainnet or calibration (default)
  • TOTAL_STORAGE_NEEDED_GiB — default 150
  • PERSISTENCE_PERIOD_DAYS — default 365
  • RUNOUT_NOTIFICATION_THRESHOLD_DAYS — default 45 (recommended >30; Filecoin warm storage requires 30 days paid upfront)

Original pricing

Storage was billed at $2.50/TiB/month, paid per-epoch (30s), with a minimum of $0.06/month. Example: 150 GiB for 1 year ≈ 0.44 USDFC.

These economics are unchanged in foc-cli, which uses the same Filecoin Warm Storage Service (FWSS) under the hood.


Links

License

MIT © @nijoe1


Built with ❤️ by @FILBuilders for the Filecoin ecosystem.

Yorumlar (0)

Sonuc bulunamadi