Akash MCP Server

Nota

Este projeto ainda está em desenvolvimento e nem todas as ferramentas estão disponíveis. Estamos trabalhando para adicionar mais ferramentas e melhorar o servidor. Estamos abertos a contribuições! Veja CONTRIBUTING.md para mais detalhes.

Visão Geral

Este servidor fornece uma ponte entre agentes de IA e a Akash Network, permitindo que modelos de IA implantem aplicações, criem leases, gerenciem deployments e interajam com outros serviços Akash diretamente por meio de ferramentas tipadas. Ele implementa o Model Context Protocol, tornando-o compatível com várias plataformas e ferramentas de IA.

Recursos

• Gerenciamento de Carteira e Cliente: Lida com autenticação de carteira Akash e inicialização de cliente
• Gerenciamento de Certificados: Gerencia certificados Akash
• Ferramentas para Interação com Akash:
  • Recuperação de endereço de conta
  • Criação, consulta, atualização e encerramento de deployments
  • Operações de SDL (Stack Definition Language)
  • Gerenciamento de lances
  • Criação de lease
  • Implantação de manifesto

Pré-requisitos

• Node.js (v18 or later)
• Uma carteira Akash (uma mnemonic ou uma chave privada codificada em hexadecimal é necessária para interação com a Akash Network)
• Conhecimento básico da Akash Network

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

   npm install
   

3. Compile o projeto:

   npm run build
   

Uso com Claude Desktop ou Cursor

Adicione o seguinte ao seu claude_desktop_config.json ou .cursor/mcp.json. Veja aqui para mais detalhes.

Certifique-se de substituir <path to dist/index.js> pelo caminho para o arquivo dist/index.js que você compilou.

{
  "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 Desenvolvimento

Execute o servidor com o MCP inspector para desenvolvimento:

npm run dev

Para o modo de observação durante o desenvolvimento:

npm run dev:watch

Usando o Servidor com Modelos de IA

O servidor expõe uma interface MCP padrão que pode ser usada por modelos de IA para interagir com a Akash Network. Ele usa o transporte stdio por padrão, tornando-o compatível com a maioria dos clientes MCP.

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas para agentes de IA:

• GetAccountAddrTool: Recupere o endereço da sua conta Akash
• GetBalancesTool: Obtenha o AKT (uakt) e outros saldos para um determinado endereço de conta Akash
• GetBidsTool: Obtenha lances para deployments
• CreateDeploymentTool: Crie um novo deployment na Akash Network
• GetDeploymentTool: Obtenha detalhes do deployment, incluindo status, grupos e conta de garantia
• CloseDeploymentTool: Feche/termine um deployment na Akash Network
• AddFundsTool: Deposite AKT (uakt) adicional em uma conta de garantia de deployment
• GetSDLsTool: Obtenha uma lista de SDLs disponíveis (do repositório awesome-akash)
• GetSDLTool: Obtenha um SDL específico pelo nome
• SendManifestTool: Envie um manifesto para um provedor
• CreateLeaseTool: Crie um lease com um provedor
• GetServicesTool: Obtenha informações sobre serviços ativos
• UpdateDeploymentTool: Atualize um deployment na Akash Network

Desenvolvimento

Linting e Formatação

# Run linter
npm run lint

# Fix linting issues
npm run lint:fix

# Format code
npm run format

Licença

Veja LICENSE

Agradecimentos

• Akash Network
• Model Context Protocol
• awesome-akash (incluído como um submódulo)