🪐 MCP IPFS 服务器(storacha.network)🛰️

一个实现模型上下文协议 (MCP) 的Node.js 服务器,用于通过w3命令行界面 ( @web3-storage/w3cli ) 与storacha.network平台进行交互。
该服务器通过无缝包装w3命令,使语言模型🤖和其他 MCP 客户端能够管理 storacha.network 空间、上传/下载数据、管理委托以及执行各种其他任务。
✨ 特点
包装
w3CLI 以实现与 storacha.network 的本地集成。提供涵盖广泛
w3功能的 MCP 工具:🔑身份验证和代理:
w3_login,w3_reset,w3_account_ls(用于检查授权)📦空间管理:
w3_space_ls、w3_space_use、w3_space_info、w3_space_add、w3_space_provision(注意:由于交互式提示,必须手动运行w3_space_create)💾数据管理:
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、上传、索引、访问声明、Filecoin 信息管理
💳账户和账单:
w3_plan_get、w3_coupon_create、w3_usage_report
Related MCP server: Deskaid
🛠️ 先决条件
**Node.js:**版本 22.0.0 或更高版本(
node -v)。**
w3CLI:**服务器直接执行w3命令。确保已全局安装@web3-storage/w3cli并配置:npm install -g @web3-storage/w3cli w3 login <your-email@example.com> # Follow email verification steps环境变量:
w3_login工具需要将W3_LOGIN_EMAIL环境变量设置为与w3 login使用的相同的电子邮件。
🏗️ 项目结构
代码库组织如下:
🚀 与 MCP 客户端一起使用
此服务器可与任何兼容 MCP 的客户端一起使用。您需要配置客户端才能连接到此服务器。
例如:NPX(建议本地简单使用)
这假设npm和先决条件都已满足。
示例:Docker
首先构建图像(参见构建部分)或使用预先构建的图像alexbakers/mcp-ipfs 。
📝 关于路径的注意事项:
一些w3命令需要绝对文件系统路径(例如, w3_up 、 w3_delegation_create --output 、 w3_proof_add 、 w3_can_blob_add 、 w3_can_store_add )。
**NPX:**提供主机的绝对路径。
Docker: 在容器内提供绝对路径。如果需要与主机上的文件进行交互(例如上传),则必须使用
-v标志(例如-v /Users/me/project:/Users/me/project)将相关的主机目录挂载到容器中,然后在工具参数中使用容器路径(例如/Users/me/project/my_file.txt)。
📦构建
克隆存储库并安装依赖项:
构建 TypeScript 代码:
然后您可以直接运行服务器:
或者发布它(如果您有权利):
🐳 Docker 构建
构建 Docker 镜像:
📜 许可证
此 MCP 服务器采用 MIT 许可证。详情请参阅许可证文件。