Lazy loaded image
MCP IPFS Server(storacha.network) 
Words 624Read Time 2 min
2025-4-5
2025-4-5
type
status
date
slug
summary
tags
category
icon
password

 

1. 项目概述 🪐

这是一个基于 Node.js 的服务器项目,主要实现了 Model Context Protocol (MCP),用于与 storacha.network 平台交互。该项目的主要特点是封装了 w3 命令行工具(@web3-storage/w3cli),使语言模型和其他 MCP 客户端能够方便地管理 storacha.network 相关功能。

2. 核心功能 ✨

项目提供了多个主要功能模块:

2.1 认证与账户管理

  • w3_login: 登录功能
  • w3_reset: 重置功能
  • w3_account_ls: 授权检查

2.2 空间管理

  • w3_space_ls: 列出空间
  • w3_space_use: 使用空间
  • w3_space_info: 空间信息
  • w3_space_add: 添加空间
  • w3_space_provision: 配置空间

2.3 数据管理

  • w3_up: 上传数据
  • w3_ls: 列出数据
  • w3_rm: 删除数据

2.4 其他功能

  • 分享功能:w3_open(生成 w3s.link URL)
  • 委托管理:w3_delegation_create, w3_delegation_ls, w3_delegation_revoke
  • 密钥和令牌管理:w3_key_create, w3_bridge_generate_tokens
  • 高级存储管理:支持 Blob、CAR、Upload 等操作
  • 账户和计费管理:w3_plan_get, w3_coupon_create, w3_usage_report

3. 系统要求 🛠️

  • Node.js: 需要 22.0.0 或更高版本
  • w3 CLI: 需要全局安装 @web3-storage/w3cli
  • 环境变量: 需要设置 W3_LOGIN_EMAIL 环境变量

4. 项目结构 🏗️

5. 使用方法 🚀

项目提供两种主要使用方式:

5.1 NPX 方式(推荐)

  • 适合简单的本地使用
  • 需要配置 mcpServers 并设置相应的环境变量

5.2 Docker 方式

  • 可以使用预构建镜像 alexbakers/mcp-ipfs
  • 需要正确配置容器路径映射
  • 注意文件路径问题:Docker 环境需要使用容器内的绝对路径

6. 重要注意事项 📝

  1. 路径处理:
      • 多个 w3 命令需要使用绝对路径
      • Docker 环境需要特别注意路径映射
      • 使用 v 参数挂载主机目录到容器
  1. 构建方式:
      • 支持直接从源码构建
      • 支持 Docker 构建
      • 提供 NPM 包安装方式

7. 许可证 📜

项目采用 MIT 许可证。
这个项目主要面向需要与 IPFS/storacha.network 交互的开发者,特别是在构建需要存储功能的语言模型应用时特别有用。它通过 MCP 协议提供了一个标准化的接口,使得存储操作变得更加简单和规范。
 
上一篇
NestJS MCP Server Module
下一篇
Opentools MCP Server