Storacha MCP存储服务器
Storacha热存储的模型上下文协议（MCP）服务器实现，允许AI应用程序通过标准化接口存储和检索文件。它使用IPFS和CID实现了无信任、去中心化的数据交换，确保了数据主权、可验证性以及与代理框架和人工智能系统的无缝集成。
免费存储选项开始🚀
立即开始您的去中心化存储之旅！
- GitHub用户：使用您的GitHub帐户注册并立即收到 100MB免费存储空间 --无需信用卡！
- 电子邮件用户：使用您的电子邮件注册并添加信用卡以解锁 5GB可用存储空间.
用例
- 文件存储和分析：安全上传和检索Blob文档。
- 长期结构化数据存储：维护针对寿命和可访问性进行优化的结构化数据存储。
- 代理和系统之间的数据共享：使用以下工具轻松跨多个代理和不同系统共享数据 CID（内容标识符），实现去中心化、可验证和高效的数据交换。
- 应用程序集成：通过模型上下文协议将Storacha存储检索无缝集成到应用程序中。
- AI模型开发：通过提供可靠的版本控制和对存储在Storacha中的外部数据集的访问来支持AI模型。
- LLM集成：通过直接与Storacha Storage连接以实现无缝数据访问，增强大型语言模型（LLM）。
- Web应用程序备份：可靠地存储web应用程序的备份副本以进行灾难恢复。
- 机器学习数据集：高效管理和访问机器学习工作流程中使用的大型数据集。
快速安装指南
只需几个简单的步骤，即可开始使用Storacha MCP存储服务器。
- 克隆存储库
git clone https://github.com/storacha/mcp-storage-server.git && cd mcp-storage-server- 再进行
pnpm install- 生成密钥和委派
- 安装CLI
npm install -g @web3-storage/w3cli- 登录Storacha
w3 login_输出：_
? How do you want to login?
Via Email
❯ Via GitHub_选择 通过GitHub 并使用您的GitHub帐户进行身份验证。_
- 创建空间
w3 space create _替换 `` 为您的新空间命名_.：警告： _请确保保存恢复密钥，以便在需要时可以从其他设备访问您的空间。_
- 创建私钥
w3 key create_输出：_
AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG
PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0=- 设置代理ID并创建委派
w3 delegation create \
--can 'store/add' \
--can 'filecoin/offer' \
--can 'upload/add' \
--can 'space/blob/add' \
--can 'space/index/add' --base64_将\替换为上一步中的AgentId。它授予代理将文件存储到最近创建的空间中的权限_.
- 配置MCP客户端
接下来，配置您的MCP客户端（如Cursor）以使用此服务器。大多数MCP客户端将配置存储为以下格式的JSON：
{
"mcpServers": {
"storacha-storage-server": {
"command": "node",
"args": ["./dist/index.js"],
"env": {
// The server supports `stdio`, `sse`, and `rest` modes, the default is `stdio`.
"MCP_TRANSPORT_MODE": "stdio",
// The Storacha Agent private key that is authorized to store data into the Space.
"PRIVATE_KEY": "",
// The base64 encoded delegation that proves the Agent is allowed to store data. If not set, MUST be provided for each upload request.
"DELEGATION": "",
},
"shell": true,
"cwd": "./",
},
},
}_替换 ` 使用您在步骤3中创建的私钥。然后，更换 ` 使用您在步骤3中创建的代表团。_
### REST模式和云托管
Storacha MCP存储服务器支持REST传输模式，该模式与MCP.so云托管兼容。要使用REST模式，请执行以下操作：
{
"mcpServers": {
"storacha-storage-server-rest": {
"url": "http://localhost:3001/rest",
},
},
}有关部署到MCP.so云的更多信息，请参阅 集成.md 导游。
_：警告：有几种方法可以配置MCP客户端，请阅读 集成.md 更多信息请参阅指南。_
工具
Storacha MCP Storage Server为AI系统提供了以下工具，用于与去中心化存储网络进行交互。
存储操作
上传
将文件上传到Storacha网络。该文件必须以base64编码的字符串形式提供，文件名中必须包含MIME类型检测的扩展名。
interface UploadParams {
// Base64 encoded file content
file: string;
// Filename with extension for MIME type detection
name: string;
// Optional: Whether to publish to Filecoin (default: false)
publishToFilecoin?: boolean;
// Optional: Custom delegation proof
delegation?: string;
// Optional: Custom gateway URL
gatewayUrl?: string;
}检索
从Storacha网络检索文件。支持的文件路径格式： CID/filename, /ipfs/CID/filename，或 ipfs://CID/filename.
interface RetrieveParams {
// Path in format: CID/filename, /ipfs/CID/filename, or ipfs://CID/filename
filepath: string;
// Optional: Whether to use multiformat base64 encoding
useMultiformatBase64?: boolean;
}身份
返回 DIDKey 从私钥存储配置加载的Storacha代理。
interface IdentityParams {
// No parameters required
}请参阅 集成.md 详细代码示例和不同集成模式（SDK、Docker等）的指南。
许可证
MIT或Apache 2许可证
支持
如需支持，请访问 Storacha支持 或在此存储库中打开问题。
