🚀 Storacha MCP 存储服务器
Storacha MCP 存储服务器是一个用于 Storacha 热存储的模型上下文协议（MCP）服务器实现。它为 AI 应用程序提供了标准化接口，使其能够轻松地存储和检索文件。该服务器利用 IPFS 和 CID 实现去中心化、无需信任的数据交换，保障了数据主权和可验证性，还能与代理框架及 AI 系统实现无缝集成。
🚀 快速开始
免费存储选项
今天即可开启您的去中心化存储之旅！
- GitHub 用户：使用 GitHub 账户注册，即可获得 100MB 的免费存储空间 — 无需信用卡！
- 邮箱用户：通过邮箱注册并添加一张信用卡，解锁 5GB 的免费存储空间
✨ 主要特性
- 文档存储与分析：安全上传和检索 blob 文档。
- 长期结构化数据存储：维护适合长期保存和访问的结构化数据。
- 代理交互：支持与代理框架及 AI 系统的无缝集成，实现灵活的数据管理。
📦 安装指南
项目初始化
git clone https://github.com/storacha/mcp-storage-server.git
cd mcp-storage-server
npm install
配置存储服务器
编辑 config.json 文件：
{
"storage": {
"provider": "ipfs",
"nodeUrl": "http://localhost:5001"
},
"identity": {
"privateKey": "your-private-key-here"
}
}
启动服务器
npm start
💻 使用示例
基础用法
Storacha MCP 存储服务器为 AI 系统提供了以下交互工具，下面是存储操作的基础用法示例。
上传文件
将文件上传至 Storacha 网络，文件需以 base64 编码格式提供，并包含文件扩展名用于 MIME 类型检测。
interface UploadParams {
// Base64 编码的文件内容
file: string;
// 带有扩展名的文件名，用于 MIME 类型检测
name: string;
// 可选：是否发布到 Filecoin（默认：false）
publishToFilecoin?: boolean;
// 可选：自定义委托证明
delegation?: string;
// 可选：自定义网关 URL
gatewayUrl?: string;
}
检索文件
从 Storacha 网络中检索文件。支持的文件路径格式包括：CID/filename、/ipfs/CID/filename 或 ipfs://CID/filename。
interface RetrieveParams {
// 路径格式：CID/