FilDOS MCP Server

AI-powered decentralized file storage on Filecoin - Built for autonomous agents using Model Context Protocol (MCP)

What is FilDOS MCP?

FilDOS MCP Server enables AI agents to autonomously manage files on the Filecoin network. Upload, organize, and search files on decentralized storage through simple MCP tool calls.

Related MCP server: MCP Filesystem Server

Key Features

• 📁 Folder Management - Create and manage folder NFTs with access control

• 📤 File Operations - Upload files to Filecoin and organize them seamlessly

• 🔍 Semantic Search - AI-powered file search using embeddings

Quick Setup

Prerequisites

• Node.js 18 or higher

• A Filecoin wallet private key

• Access to Filecoin Calibration Network (testnet)

Installation

1. Clone and install dependencies

   git clone https://github.com/ArqosLabs/FilDOS-MCP.git
   cd FilDOS-MCP
   npm install

2. Configure environment variables

   cp .env.example .env

   Edit .env with your configuration:

   # Required: Your wallet private key (get test FIL from faucet)
   PRIVATE_KEY=your_private_key_here

   Go to fildos.cloud, setup your account, add tokens and configure storage for usage.

3. Build the server

   npm run build

Adding to Claude Desktop

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "fildos": {
      "command": "node",
      "args": ["/absolute/path/to/FilDOS-MCP/build/index.js"]
    }
  }
}

Restart Claude Desktop to load the server.

Resources

• FilDOS Documentation

• Model Context Protocol

• Filecoin Docs

• Synapse SDK