🪐 MCP IPFS Server (storacha.network) 🛰️
2025.04.10
2
TypeScript数据管理存储服务其它
MCP IPFS Server 是一个基于 Node.js 的服务器，实现了 Model Context Protocol (MCP)，用于通过 `w3` 命令行工具与 storacha.network 平台进行交互。该服务器使语言模型和其他 MCP 客户端能够管理 storacha.network 空间、上传/下载数据、管理授权以及执行其他任务。
View on GitHub
Overview
基本能力
产品定位
MCP IPFS Server 是一个用于与 storacha.network 平台交互的 MCP 服务器，主要用于数据管理和存储服务。
核心功能
- 封装
w3CLI，实现与 storacha.network 的原生集成。 - 提供广泛的
w3功能，包括： - 认证与代理管理：
w3_login,w3_reset,w3_account_ls - 空间管理：
w3_space_ls,w3_space_use,w3_space_info,w3_space_add,w3_space_provision - 数据管理：
w3_up,w3_ls,w3_rm - 共享：
w3_open（生成 w3s.link URL） - 授权与证明：
w3_delegation_create,w3_delegation_ls,w3_delegation_revoke,w3_proof_add,w3_proof_ls - 密钥与令牌：
w3_key_create,w3_bridge_generate_tokens - 高级存储管理：Blob, CAR, Upload, Index, Access Claim, Filecoin Info 管理
- 账户与计费：
w3_plan_get,w3_coupon_create,w3_usage_report
适用场景
- 语言模型或其他 MCP 客户端需要与 storacha.network 平台交互的场景。
- 需要管理存储空间、上传/下载数据、管理授权等任务的场景。
工具列表
w3CLI：用于与 storacha.network 平台交互的命令行工具。
常见问题解答
- 路径问题：
w3命令需要绝对路径，Docker 使用时需注意容器内路径。 - 认证问题：确保
W3_LOGIN_EMAIL环境变量已设置。
使用教程
使用依赖
- 安装 Node.js 22.0.0 或更高版本：
bash node -v - 安装
w3CLI：bash npm install -g @web3-storage/w3cli w3 login <[email protected]> # 按照邮件验证步骤操作 - 设置环境变量：
bash export W3_LOGIN_EMAIL="[email protected]"
安装教程
- 克隆仓库并安装依赖：
bash git clone https://github.com/alexbakers/mcp-ipfs.git cd mcp-ipfs npm install - 构建 TypeScript 代码：
bash npm run build - 运行服务器：
bash node dist/index.js
调试方式
- 确保
W3_LOGIN_EMAIL环境变量已设置。 - 运行服务器并检查日志输出：
bash node dist/index.js - 使用 MCP 客户端连接服务器进行测试。