Storacha

🚀 Storacha MCP 存儲服務器

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 網絡，文件需以 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/
  // 這裡原文檔未完整給出 RetrieveParams 接口的內容，保持原樣
}