Storacha MCP Storage Server

Servidor de almacenamiento Storacha MCP

Implementación de servidor del Protocolo de Contexto de Modelo (MCP) para el almacenamiento en caliente de Storacha, que permite a las aplicaciones de IA almacenar y recuperar archivos mediante una interfaz estandarizada. Facilita el intercambio de datos descentralizado y sin confianza mediante IPFS y CID, lo que garantiza la soberanía de los datos, la verificabilidad y una integración fluida con los marcos de agentes y los sistemas de IA.

Opciones de almacenamiento gratuitas para empezar 🚀

¡Empiece hoy mismo su viaje hacia el almacenamiento descentralizado!

• Usuarios de GitHub : regístrense con su cuenta de GitHub y reciban instantáneamente 100 MB de almacenamiento gratuito , ¡sin necesidad de tarjeta de crédito!
• Usuarios de correo electrónico : Regístrese con su correo electrónico y agregue una tarjeta de crédito para desbloquear 5 GB de espacio de almacenamiento gratuito .

Casos de uso

• Almacenamiento y análisis de documentos : cargue y recupere documentos Blob de forma segura.
• Almacenamiento de datos estructurados a largo plazo : mantenga el almacenamiento de datos estructurados optimizado para la longevidad y la accesibilidad.
• Intercambio de datos entre agentes y sistemas : comparta datos fácilmente entre múltiples agentes y diversos sistemas utilizando CID (identificadores de contenido) , lo que permite un intercambio de datos descentralizado, verificable y eficiente.
• Integración de aplicaciones : integre sin problemas la recuperación de almacenamiento de Storacha en las aplicaciones a través del Protocolo de contexto de modelo.
• Desarrollo de modelos de IA : respalde los modelos de IA proporcionando versiones confiables y acceso a conjuntos de datos externos almacenados en Storacha.
• Integración LLM : mejore los modelos de lenguaje grandes (LLM) conectándose directamente con Storacha Storage para obtener un acceso perfecto a los datos.
• Copias de seguridad de aplicaciones web : almacene de forma confiable copias de seguridad de aplicaciones web para recuperación ante desastres.
• Conjuntos de datos de aprendizaje automático : administre y acceda de manera eficiente a grandes conjuntos de datos utilizados en flujos de trabajo de aprendizaje automático.

Guía de instalación rápida

Comience a utilizar el servidor de almacenamiento Storacha MCP en solo unos sencillos pasos.

1. Clonar el repositorio
   git clone https://github.com/storacha/mcp-storage-server.git && cd mcp-storage-server
2. Instalar dependencias
   pnpm install
3. Generar claves y delegación
   • Instalar la CLI
     npm install -g @web3-storage/w3cli
   • Iniciar sesión en Storacha
     w3 login
     Producción:
     ? How do you want to login? Via Email ❯ Via GitHub
     Seleccione Vía GitHub y autentíquese con su cuenta de GitHub.
   • Crea un espacio
     w3 space create <your_space_name>
     Reemplace <your_space_name> con un nombre para su nuevo espacio . : Asegúrese de guardar la clave de recuperación, para que pueda acceder a su espacio desde otro dispositivo si es necesario.
   • Crear una clave privada
     w3 key create
     Producción:
     AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0=
   • Establecer el ID del agente y crear una delegación
     w3 delegation create <agent_id> \ --can 'store/add' \ --can 'filecoin/offer' \ --can 'upload/add' \ --can 'space/blob/add' \ --can 'space/index/add' --base64
     Reemplace <agent_id> con el AgentId del paso anterior. Esto le otorga al agente permiso para almacenar archivos en el espacio creado recientemente .
4. Configurar el cliente MCPA continuación, configure su cliente MCP (como Cursor) para usar este servidor. La mayoría de los clientes MCP almacenan la configuración como JSON en el siguiente formato:
   { "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": "<agent_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": "<base64_delegation>", }, "shell": true, "cwd": "./", }, }, }
   Reemplace <agent_private_key> con la PrivateKey que creó en el paso 3. Luego, reemplace <base64_delegation> con la delegación que creó en el paso 3.

Modo REST y alojamiento en la nube

El servidor de almacenamiento Storacha MCP admite el modo de transporte REST, compatible con el alojamiento en la nube MCP.so. Para usar el modo REST:

Para obtener más información sobre la implementación en la nube MCP.so, consulte la guía de integraciones.md .

: Hay varias formas de configurar clientes MCP, lea la guía de integraciones.md para obtener más información.

Herramientas

El servidor de almacenamiento Storacha MCP proporciona las siguientes herramientas para que los sistemas de IA interactúen con una red de almacenamiento descentralizada.

Operaciones de almacenamiento

subir

Sube un archivo a la red Storacha. El archivo debe proporcionarse como una cadena codificada en base64 con un nombre que incluya la extensión para la detección del tipo MIME.

recuperar

Recuperar un archivo de la red Storacha. Formatos de ruta de archivo compatibles: CID/filename , /ipfs/CID/filename o ipfs://CID/filename .

identidad

Devuelve la DIDKey del Agente Storacha cargado desde la configuración de almacenamiento de clave privada.

Consulte la guía de integraciones.md para obtener ejemplos de código detallados y diferentes patrones de integración (SDK, Docker, etc.).

Licencia

Licencia MIT o Apache 2

Apoyo

Para obtener ayuda, visite el Soporte de Storacha o abra un problema en este repositorio.