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. 重要注意事项 📝
- 路径处理:
- 多个
w3
命令需要使用绝对路径 - Docker 环境需要特别注意路径映射
- 使用
v
参数挂载主机目录到容器
- 构建方式:
- 支持直接从源码构建
- 支持 Docker 构建
- 提供 NPM 包安装方式
7. 许可证 📜
项目采用 MIT 许可证。
这个项目主要面向需要与 IPFS/storacha.network 交互的开发者,特别是在构建需要存储功能的语言模型应用时特别有用。它通过 MCP 协议提供了一个标准化的接口,使得存储操作变得更加简单和规范。
- Author:二师兄
- URL:https://cloudesx.com/article/ipfs-mcp-server
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!