Nano Currency MCP Server

Nano Currency MCP Server

Nano Currency MCP Server dá a clientes compatíveis com MCP (incluindo agentes de IA) a capacidade de enviar moeda Nano e recuperar informações de conta e bloco via RPC do nó Nano.

Agentes de IA estão adotando cada vez mais o padrão MCP e este servidor dá a eles a capacidade de enviar Nano a pedido de seus proprietários ou possivelmente de forma autônoma em algumas configurações 🤖

Nano Currency MCP Server também permite a criação de cabeçalhos compatíveis com x402, dando aos agentes de IA a capacidade de pagar por APIs/recursos usando Nano.

❔ O que é MCP?

O Model Context Protocol (MCP) é um framework aberto que define uma abordagem padronizada para aplicações entregarem contexto a Grandes Modelos de Linguagem (LLMs).

❔ O que é a moeda Nano?

Nano é uma moeda digital projetada para permitir transações rápidas, escaláveis e sem taxas. Ela visa resolver problemas comuns em criptomoedas tradicionais, como altas taxas e processamento lento, tornando-a uma opção eficiente para pagamentos peer-to-peer do dia a dia. Saiba mais em nano.org

❔ O que é x402?

x402 é um protocolo de pagamento nativo da internet que revive o código de status HTTP 402 Payment Required não utilizado para habilitar pagamentos instantâneos, programáticos e sem permissão pela web. Saiba mais em x402.org. Esquemas x402 específicos para Nano e código de implementação podem ser encontrados no recurso x402nano no GitHub.

🚨 Antes de Prosseguir 🚨

Cuidado: LLMs podem alucinar e nem sempre se comportar como você deseja, então teste este servidor com pequenas quantidades de Nano. Use as variáveis de ambiente RAW_MAX_SEND_AMOUNT ou NANO_MAX_SEND_AMOUNT descritas posteriormente para restringir a quantidade máxima de Nano que pode ser enviada por vez.

🛠️ Ferramentas Fornecidas pelo Nano Currency MCP Server

🔧 raw_send - Envia uma quantidade especificada de unidades raw de uma conta Nano predefinida para uma conta Nano de destino.

🔧 nano_send - Envia uma quantidade especificada de unidades nano de uma conta Nano predefinida para uma conta Nano de destino.

🔧 nano_account_info - Recupera informações detalhadas sobre uma conta Nano específica, incluindo saldo (em unidades nano e raw), representante e bloco frontier.

🔧 nano_my_account_info - Recupera informações detalhadas sobre minha conta Nano, incluindo saldo (em unidades nano e raw), representante e bloco frontier. Esta é a conta usada para enviar Nano.

🔧 block_info - Recupera informações detalhadas sobre um bloco Nano específico.

🔧 x402_payment_signature_exact_scheme_create - Cria o cabeçalho PAYMENT-SIGNATURE para uma transação Nano x402 em conformidade com o esquema exato.

🔌 Instalação

Certifique-se de ter Node.js com NPM instalado no seu sistema.

git clone https://github.com/kilkelly/nano-currency-mcp-server.git
cd nano-currency-mcp-server
npm install

Você precisará de um cliente MCP para se conectar ao Nano Currency MCP Server. Cada cliente terá sua própria forma de se conectar a servidores MCP. Para o cliente escolhido, você precisará descobrir como as variáveis de ambiente de um servidor MCP são definidas. Quando souber como, você precisará definir as seguintes variáveis de ambiente para usar o Nano Currency MCP Server.

⚙️ Variáveis de Ambiente

NANO_RPC_URL (obrigatório) - URL que deve ser usada para se comunicar com um RPC de nó Nano. Pode ser um endpoint local ou hospedado remotamente.

NANO_WORK_GENERATION_URL - URL que deve ser usada para se comunicar com um endpoint que suporta o comando RPC work_generate para geração de trabalho. Se não for especificada, o padrão é NANO_RPC_URL. Usada pelas ferramentas 🔧 nano_send 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create

NANO_PRIVATE_KEY - Chave privada Nano que será usada para assinar transações de envio e para derivar a conta Nano. Cuidado: 🚨NÃO É A SEMENTE DA CARTEIRA🚨. Teste com a chave privada de uma conta com saldo pequeno de Nano. Usada pelas ferramentas 🔧 nano_send 🔧 raw_send 🔧 nano_my_account_info 🔧 x402_payment_signature_exact_scheme_create

RAW_MAX_SEND_AMOUNT - Quantidade máxima (em unidades raw) que pode ser enviada em uma única transação. Por segurança, o valor máximo padrão de envio é 10000000000000000000000000000 raw (Ӿ0.01). Você deve definir esta variável explicitamente para conceder o poder de enviar quantidades maiores. Usada pelas ferramentas 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create

NANO_MAX_SEND_AMOUNT - Quantidade máxima (em unidades nano) que pode ser enviada em uma única transação. Por segurança, o valor máximo padrão de envio é 0.01 nano (Ӿ0.01). Você deve definir esta variável explicitamente para conceder o poder de enviar quantidades maiores. Usada pelas ferramentas 🔧 nano_send 🔧 x402_payment_signature_exact_scheme_create

X402_NANO_NETWORK - A rede Nano para a qual uma transação Nano x402 está sendo criada. A rede padrão é "nano:mainnet". Usada pelas ferramentas 🔧 x402_payment_signature_exact_scheme_create

Exemplo de Configuração

O seguinte é um exemplo de configuração para Nano Currency MCP Server no Claude Desktop.

{
  "mcpServers": {
    "nano_currency": {
      "command": "ENTER FULL FILE PATH TO node.exe ON YOUR SYSTEM",
      "args": [
        "ENTER FULL FILE PATH TO nano-currency.js FILE FROM THIS REPOSITORY"
      ],
      "env": {
        "NANO_RPC_URL": "ENTER YOUR NANO_RPC_URL",
        "NANO_WORK_GENERATION_URL": "ENTER YOUR NANO_WORK_GENERATION_URL",
        "NANO_PRIVATE_KEY": "ENTER YOUR NANO_PRIVATE_KEY",
        "RAW_MAX_SEND_AMOUNT": "ENTER A RAW_MAX_SEND_AMOUNT (in raw units, example 10000000000000000000000000000)",
        "NANO_MAX_SEND_AMOUNT": "ENTER A NANO_MAX_SEND_AMOUNT (in nano units, example 0.001, 1.000)",
        "X402_NANO_NETWORK": "ENTER YOUR X402_NANO_NETWORK"
      }      
    }    
  }
}

🚨 Aviso Legal 🚨

Como sempre ao trabalhar com valor do mundo real, neste caso Nano, tenha cuidado ao usar este software. Os autores e colaboradores não serão responsabilizados por qualquer uso da funcionalidade deste software, intencional ou não, que leve a uma perda indesejada de fundos.

📄 Licença

MIT