Storacha MCP 存储服务器

一个用于 Storacha 热存储的模型上下文协议（MCP）服务器实现，允许 AI 应用程序通过标准化接口存储和检索文件。它利用 IPFS 和 CID 实现去中心化、无需信任的数据交换，确保数据主权、可验证性和与代理框架及 AI 系统的无缝集成。

免费存储选项立即开始 🚀

今天即可开启您的 decentralized 存储之旅！

• 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/