Peppermint Server

Un servidor Model Context Protocol (MCP) para la API de Peppermint Tools. Proporciona acceso completo a funcionalidades blockchain incluyendo contratos inteligentes, tokens, NFTs y más.

Características

• 18 herramientas MCP para operaciones blockchain
• Autenticación flexible: Plain API Key (recomendada) y HMAC-SHA512
• Operaciones completas: Blockchains, contratos, tokens, vaults, transacciones
• Auto-configuración: Detecta vaults automáticamente

Instalación

npm install
npm run build

Configuración

Variables de entorno:

• PEPPERMINT_API_KEY: Tu API key de Peppermint
• PEPPERMINT_INSECURE_KEY: "1" para Plain API Key, "0" para HMAC

Para Claude Desktop:

{
  "mcpServers": {
    "peppermint": {
      "command": "node",
      "args": ["/ruta/completa/al/proyecto/dist/flexible-server.js"],
      "env": {
        "PEPPERMINT_API_KEY": "tu-api-key",
        "PEPPERMINT_INSECURE_KEY": "1"
      }
    }
  }
}

Uso

# Ejecutar servidor
npm start

# Desarrollo
npm run dev

Herramientas Disponibles

Información

• get_auth_info - Ver método de autenticación actual

Blockchain

• list_blockchains - Listar blockchains disponibles
• get_blockchain - Obtener detalles de blockchain

Contratos

• list_contracts - Listar contratos
• get_contract - Obtener contrato específico
• deploy_contract - Desplegar contrato
• read_contract - Leer datos de contrato
• write_contract - Escribir datos a contrato

Tokens

• create_token - Crear token ERC20
• mint_token - Mint tokens
• burn_token - Burn tokens
• transfer_erc20 - Transferir tokens ERC20 desde un wallet

Vaults

• list_vaults - Listar vaults
• get_vault - Obtener vault específico
• create_vault - Crear vault

Transacciones

• list_transactions - Listar transacciones
• get_transaction - Obtener transacción específica

Wallets

• create_wallet - Crear wallet

Estructura del Proyecto

src/
├── flexible-server.ts    # Servidor MCP principal
├── flexible-client.ts    # Cliente API de Peppermint
├── flexible-auth.ts      # Sistema de autenticación
└── types.ts             # Definiciones de tipos

Licencia

ISC