Servidor IPFS MCP (storacha.network) 🛰️

Un servidor Node.js que implementa el Protocolo de contexto de modelo (MCP) para interactuar con la plataforma storacha.network a través de la interfaz de línea de comandos w3 ( @web3-storage/w3cli ).

Este servidor permite a los modelos de lenguaje 🤖 y otros clientes MCP administrar espacios de storacha.network, cargar/descargar datos, administrar delegaciones y realizar varias otras tareas al encapsular perfectamente los comandos w3 .

✨ Características

• Envuelve la CLI w3 para la integración nativa con storacha.network.

• Proporciona herramientas MCP que cubren una amplia gama de funcionalidades w3 :

  • 🔑 Autenticación y agente: w3_login , w3_reset , w3_account_ls (para comprobar la autorización)

  • 📦 Gestión del espacio: w3_space_ls , w3_space_use , w3_space_info , w3_space_add , w3_space_provision (Nota: w3_space_create debe ejecutarse manualmente debido a las indicaciones interactivas)

  • 💾 Gestión de datos: w3_up , w3_ls , w3_rm

  • 🔗 Compartir: w3_open (genera la URL w3s.link)

  • 🤝 Delegaciones y pruebas: w3_delegation_create , w3_delegation_ls , w3_delegation_revoke , w3_proof_add , w3_proof_ls

  • 🔐 Claves y tokens: w3_key_create , w3_bridge_generate_tokens

  • ⚙️ Almacenamiento avanzado ( Blob, CAR, Carga, Índice, Reclamo de acceso, Gestión de información de Filecoin

  • 💳 Cuenta y facturación: w3_plan_get , w3_coupon_create , w3_usage_report

Related MCP server: Deskaid

🛠️ Requisitos previos

• Node.js: Versión 22.0.0 o superior ( node -v ).

• CLI El servidor ejecuta comandos w3 directamente. Asegúrese de que @web3-storage/w3cli esté instalado globalmente y configurado.

  npm install -g @web3-storage/w3cli w3 login <your-email@example.com> # Follow email verification steps

• Variable de entorno: La herramienta w3_login requiere que la variable de entorno W3_LOGIN_EMAIL se configure con el mismo correo electrónico utilizado para w3 login .

🏗️ Estructura del proyecto

El código base está organizado de la siguiente manera:

🚀 Uso con clientes MCP

Este servidor se puede usar con cualquier cliente compatible con MCP. Debe configurar su cliente para conectarse a este servidor.

Ejemplo: NPX (Recomendado para uso local simple)

Esto supone que se cumplen npm y los requisitos previos.

Ejemplo: Docker

Primero construya la imagen (ver la sección Construir) o use la imagen preconstruida alexbakers/mcp-ipfs .

📝 Nota sobre los caminos:

Varios comandos w3 requieren rutas de sistema de archivos absolutas (por ejemplo, w3_up , w3_delegation_create --output , w3_proof_add , w3_can_blob_add , w3_can_store_add ).

• NPX: proporcione rutas absolutas desde su máquina host.

• Docker: Proporcione rutas absolutas dentro del contenedor . Si interactúa con archivos desde su host (p. ej., al subirlos), debe montar el directorio del host correspondiente en el contenedor usando el parámetro -v (p. ej., -v /Users/me/project:/Users/me/project ) y luego usar la ruta del contenedor (p. ej., /Users/me/project/my_file.txt ) en los argumentos de la herramienta.

📦 Construir

Clonar el repositorio e instalar las dependencias:

Construya el código TypeScript:

Luego puedes ejecutar el servidor directamente:

O publicarlo (si tienes los derechos):

🐳 Compilación de Docker

Construya la imagen de Docker:

📜 Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.