Nano Currency MCP Server

Envía moneda Nano y recupera información de cuentas y bloques usando el RPC del nodo Nano.

Documentación

Nano Currency MCP Server

Nano Currency MCP Server brinda a los clientes compatibles con MCP (incluidos los agentes de IA) la capacidad de enviar moneda Nano y recuperar información de cuentas y bloques a través del RPC del nodo Nano.

Los agentes de IA están adoptando cada vez más el estándar MCP y este servidor les brinda la capacidad de enviar Nano a petición de su propietario o posiblemente de forma autónoma en algunas configuraciones 🤖

Nano Currency MCP Server también permite la creación de encabezados compatibles con x402, dando a los agentes de IA la capacidad de pagar por API/recursos usando Nano.

❔ ¿Qué es MCP?

El Protocolo de Contexto de Modelos (MCP) es un marco abierto que define un enfoque estandarizado para que las aplicaciones entreguen contexto a los Modelos de Lenguaje Grande (LLMs).

❔ ¿Qué es Nano Currency?

Nano es una moneda digital diseñada para permitir transacciones rápidas, escalables y sin comisiones. Su objetivo es abordar problemas comunes en las criptomonedas tradicionales, como las altas comisiones y los tiempos de procesamiento lentos, convirtiéndola en una opción eficiente para pagos entre pares en el día a día. Obtén más información en nano.org

❔ ¿Qué es x402?

x402 es un protocolo de pago nativo de internet que revive el código de estado HTTP 402 Payment Required no utilizado para habilitar pagos instantáneos, programáticos y sin permisos a través de la web. Obtén más información en x402.org. Los esquemas x402 específicos de Nano y el código de implementación se pueden encontrar en el recurso de GitHub x402nano.

🚨 Antes de Continuar 🚨

Precaución: Los LLMs pueden alucinar y no siempre actuar como deseas, así que prueba este servidor con pequeñas cantidades de Nano. Usa las variables de entorno RAW_MAX_SEND_AMOUNT o NANO_MAX_SEND_AMOUNT descritas más adelante para restringir la cantidad máxima de Nano que se puede enviar a la vez.

🛠️ Herramientas Proporcionadas por Nano Currency MCP Server

🔧 raw_send - Envía una cantidad especificada de unidades raw desde una cuenta Nano predefinida a una cuenta Nano de destino.

🔧 nano_send - Envía una cantidad especificada de unidades nano desde una cuenta Nano predefinida a una cuenta Nano de destino.

🔧 nano_account_info - Recupera información detallada sobre una cuenta Nano específica, incluido el saldo (en unidades nano y raw), el representante y el bloque frontera.

🔧 nano_my_account_info - Recupera información detallada sobre mi cuenta Nano, incluido el saldo (en unidades nano y raw), el representante y el bloque frontera. Esta es la cuenta que se utiliza para enviar Nano.

🔧 block_info - Recupera información detallada sobre un bloque Nano específico.

🔧 x402_payment_signature_exact_scheme_create - Crea el encabezado PAYMENT-SIGNATURE para una transacción Nano x402 conforme al esquema exacto.

🔌 Instalación

Asegúrate de tener Node.js con NPM instalado en tu sistema.

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

Necesitarás un cliente MCP para conectarte a Nano Currency MCP Server. Cada cliente tendrá su propia forma de conectarse a los servidores MCP. Para el cliente que elijas, tendrás que averiguar cómo se configuran las variables de entorno para un servidor MCP. Cuando lo sepas, necesitarás configurar las siguientes variables de entorno para usar el Nano Currency MCP Server.

⚙️ Variables de Entorno

NANO_RPC_URL (obligatorio) - URL que se debe usar para comunicarse con un RPC de nodo Nano. Puede ser un endpoint local o alojado de forma remota.

NANO_WORK_GENERATION_URL - URL que se debe usar para comunicarse con un endpoint que admita el comando RPC work_generate para la generación de trabajo. Si no se especifica, el valor predeterminado es NANO_RPC_URL. Usado por las herramientas 🔧 nano_send 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create

NANO_PRIVATE_KEY - Clave privada de Nano que se usará para firmar transacciones de envío y para derivar la cuenta Nano. Precaución: 🚨NO ES LA SEMILLA DE LA CARTERA🚨. Prueba con la clave privada de una cuenta con un saldo pequeño de Nano. Usada por las herramientas 🔧 nano_send 🔧 raw_send 🔧 nano_my_account_info 🔧 x402_payment_signature_exact_scheme_create

RAW_MAX_SEND_AMOUNT - Cantidad máxima (en unidades raw) que se puede enviar en una sola transacción. Por razones de seguridad, la cantidad máxima de envío predeterminada es 10000000000000000000000000000 raw (Ӿ0.01). Debes configurar esta variable explícitamente para otorgar la capacidad de enviar cantidades mayores. Usada por las herramientas 🔧 raw_send 🔧 x402_payment_signature_exact_scheme_create

NANO_MAX_SEND_AMOUNT - Cantidad máxima (en unidades nano) que se puede enviar en una sola transacción. Por razones de seguridad, la cantidad máxima de envío predeterminada es 0.01 nano (Ӿ0.01). Debes configurar esta variable explícitamente para otorgar la capacidad de enviar cantidades mayores. Usada por las herramientas 🔧 nano_send 🔧 x402_payment_signature_exact_scheme_create

X402_NANO_NETWORK - La red Nano para la que se está creando una transacción Nano x402. La red predeterminada es "nano:mainnet". Usada por las herramientas 🔧 x402_payment_signature_exact_scheme_create

Ejemplo de Configuración

El siguiente es un ejemplo de configuración para Nano Currency MCP Server en 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 siempre cuando se trabaja con valor del mundo real, en este caso Nano, ten cuidado al usar este software. Los autores y colaboradores no serán responsables de ningún uso de la funcionalidad de este software, intencional o no, que conduzca a una pérdida no deseada de fondos.

📄 Licencia

MIT