Storacha MCP Storage Server
2025.04.18
6
TypeScript去中心化存储AI 数据交互文件管理
Storacha MCP Storage Server 是一个基于 Model Context Protocol (MCP) 的服务实现，旨在为 AI 应用提供与去中心化存储交互的标准化接口。该服务支持文件操作、身份管理、多种传输模式（HTTP/SSE 和 Stdio）以及安全特性，适用于文档存储与分析、长期结构化数据存储、数据共享、应用集成等多种场景。
View on GitHub
Overview
基本能力
产品定位
Storacha MCP Storage Server 是一个为 AI 应用提供去中心化存储交互的标准化接口的服务。
核心功能
- 文件操作：上传文件到 Storacha 的去中心化存储网络，通过 HTTP 网关检索文件。
- 身份管理：获取 Storacha 代理的 DID 密钥。
- 双传输模式：支持 HTTP 与 Server-Sent Events (SSE) 实时通信，以及 Stdio 传输用于本地集成。
- 标准化接口：符合 MCP 的 API，支持工具发现和调用，处理 JSON-RPC 消息。
- 安全特性：包括 Bearer Token、CORS 配置、输入验证和安全错误处理。
适用场景
- 文档存储与分析：安全上传和检索 Blob 文档。
- 长期结构化数据存储：维护优化长期可访问的结构化数据存储。
- 数据共享：通过 CIDs（内容标识符）在多个代理和系统之间共享数据。
- 应用集成：通过 MCP 无缝集成 Storacha 存储检索功能。
- AI 模型开发：为 AI 模型提供可靠的外部数据集访问。
- LLM 集成：增强大型语言模型（LLMs）的直接数据访问能力。
- Web 应用备份：可靠存储 Web 应用的备份副本。
- 机器学习数据集：高效管理和访问机器学习工作流中的大型数据集。
工具列表
- identity：获取代理的 DID 密钥。
- retrieve：通过 HTTP 网关检索文件。
- upload：上传文件到去中心化存储网络。
常见问题解答
- 连接问题：检查服务器日志和环境变量设置。
- 传输模式：确保服务器以 SSE 或 Stdio 模式运行以兼容 Inspector。
使用教程
使用依赖
- 克隆仓库
bash git clone https://github.com/storacha/mcp-storage-server.git cd mcp-storage-server - 安装依赖
bash pnpm install - 创建
.env文件bash cp .env.example .env - 配置环境变量 ```env # MCP Server Configuration MCP_SERVER_PORT=3001 MCP_SERVER_HOST=0.0.0.0 MCP_CONNECTION_TIMEOUT=30000 MCP_TRANSPORT_MODE=stdio
# Security SHARED_ACCESS_TOKEN=
# Storage Client Configuration PRIVATE_KEY= DELEGATION= GATEWAY_URL=https://storacha.link
# File Limits MAX_FILE_SIZE=104857600 ```
安装教程
- 启动 Stdio 服务器（推荐本地通信）
bash pnpm start:stdio - 启动 SSE 服务器（推荐远程通信）
bash pnpm start:sse
调试方式
- 使用 MCP Inspector 测试
bash pnpm inspect:stdio - 启动服务器
bash pnpm start:stdio - 访问 Inspector UI（http://localhost:5173/#tools）并连接服务器。