Akash MCP Server

Nota

Este proyecto aún está en desarrollo y no todas las herramientas están disponibles. Estamos trabajando para agregar más herramientas y mejorar el servidor. ¡Estamos abiertos a contribuciones! Consulta CONTRIBUTING.md para más detalles.

Resumen

Este servidor proporciona un puente entre agentes de IA y la Red Akash, permitiendo que los modelos de IA implementen aplicaciones, creen arrendamientos, gestionen implementaciones e interactúen con otros servicios de Akash directamente a través de herramientas tipadas. Implementa el Protocolo de Contexto de Modelo, haciéndolo compatible con diversas plataformas y herramientas de IA.

Características

• Gestión de Cartera y Cliente: Maneja la autenticación de la cartera de Akash y la inicialización del cliente
• Gestión de Certificados: Administra certificados de Akash
• Herramientas para Interacción con Akash:
  • Recuperación de dirección de cuenta
  • Creación, consulta, actualización y terminación de implementaciones
  • Operaciones con SDL (Lenguaje de Definición de Pila)
  • Gestión de ofertas
  • Creación de arrendamientos
  • Implementación de manifiestos

Requisitos previos

• Node.js (v18 o posterior)
• Una cartera de Akash (se requiere un mnemónico o una clave privada codificada en hexadecimal para interactuar con la Red Akash)
• Conocimiento básico de la Red Akash

Instalación

1. Clona el repositorio:

   git clone https://github.com/akash-network/mcp.git
   cd mcp
   

2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Uso con Claude Desktop o Cursor

Agrega lo siguiente a tu claude_desktop_config.json o .cursor/mcp.json. Consulta aquí para más detalles.

Asegúrate de reemplazar <path to dist/index.js> con la ruta al archivo dist/index.js que compilaste.

{
  "mcpServers": {
    "Akash": {
      "command": "node",
      "args": ["<path to dist/index.js>"],
      "env": {
        "AKASH_MNEMONIC": "<your mnemonic here>", // OR "AKASH_PRIVATE_KEY": "<your 64-character hex string>"
        "AKASH_RPC_URL": "https://rpc.akashnet.net:443" // optional, defaults to https://rpc.akashnet.net:443
      }
    }
  }
}

Uso

Modo de Desarrollo

Ejecuta el servidor con el inspector de MCP para desarrollo:

npm run dev

Para modo de observación durante el desarrollo:

npm run dev:watch

Uso del Servidor con Modelos de IA

El servidor expone una interfaz estándar de MCP que puede ser utilizada por modelos de IA para interactuar con la Red Akash. Utiliza el transporte stdio por defecto, lo que lo hace compatible con la mayoría de los clientes de MCP.

Herramientas Disponibles

El servidor proporciona las siguientes herramientas para agentes de IA:

• GetAccountAddrTool: Recupera la dirección de tu cuenta de Akash
• GetBalancesTool: Obtiene los saldos de AKT (uakt) y otros para una dirección de cuenta de Akash dada
• GetBidsTool: Obtiene ofertas para implementaciones
• CreateDeploymentTool: Crea una nueva implementación en la Red Akash
• GetDeploymentTool: Obtiene detalles de la implementación, incluidos estado, grupos y cuenta de depósito en garantía
• CloseDeploymentTool: Cierra/termina una implementación en la Red Akash
• AddFundsTool: Deposita AKT adicional (uakt) en una cuenta de depósito en garantía de implementación
• GetSDLsTool: Obtiene una lista de SDLs disponibles (del repositorio awesome-akash)
• GetSDLTool: Obtiene un SDL específico por nombre
• SendManifestTool: Envía un manifiesto a un proveedor
• CreateLeaseTool: Crea un arrendamiento con un proveedor
• GetServicesTool: Obtiene información sobre servicios activos
• UpdateDeploymentTool: Actualiza una implementación en la Red Akash

Desarrollo

Linting y Formateo

# Run linter
npm run lint

# Fix linting issues
npm run lint:fix

# Format code
npm run format

Licencia

Consulta LICENCIA

Agradecimientos

• Red Akash
• Protocolo de Contexto de Modelo
• awesome-akash (incluido como submódulo)