XRPL MCP

XRPL MCP

XRPL MCP é uma implementação de servidor Model Context Protocol (MCP) para a blockchain XRP Ledger, compatível com clientes MCP como Claude Desktop ou Cursor.ai. Ele permite gerenciar operações de carteira, criação de tokens, NFTs e negociação DEX por meio de ferramentas abrangentes.

Recursos

• Mais de 15 ferramentas MCP cobrindo gerenciamento de contas, operações de tokens, gerenciamento de NFTs e negociação DEX
• Integração completa com XRPL para pagamentos, linhas de confiança e gerenciamento de contas
• Suporte a NFToken para cunhagem, queima e gerenciamento de tokens não fungíveis
• Recursos de negociação DEX com acesso ao livro de ordens e gerenciamento de ofertas
• Gerenciamento abrangente de transações com análises detalhadas e histórico
• Criação e gerenciamento de tokens com configurações personalizáveis e recursos de conformidade

Usando com o Claude Desktop

1. Instale o Claude Desktop se ainda não o fez
2. Abra as configurações do Claude Desktop
3. Adicione o cliente XRPL MCP à sua configuração:

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY", 
        "--xrpl_network=mainnet"
      ],
      "disabled": false
    }
  }
}

Este modo de chave privada é recomendado para usuários avançados que podem gerenciar suas chaves privadas com segurança. O cliente MCP lida com transações localmente sem expor dados a servidores externos.

Casos de Uso

1. Gerenciamento Profissional de Tokens

O agente integra-se aos recursos nativos do XRPL para ajudá-lo a:

• Criar e configurar tokens personalizados com configurações de conformidade
• Gerenciar linhas de confiança para emissão e distribuição de tokens
• Monitorar saldos de tokens em múltiplas moedas
• Executar transferências de tokens com tags de destino e memos
• Rastrear histórico de transações e analisar padrões de pagamento

2. Criação e Negociação de NFTs

O agente auxilia em operações NFToken:

• Cunhar NFTokens exclusivos com metadados personalizados e taxas de transferência
• Queimar NFTokens indesejados para limpar coleções
• Definir restrições de transferência e estruturas de royalties
• Gerenciar coleções de NFTs com categorização adequada

3. Negociação DEX e Criação de Mercado

O agente fornece ferramentas profissionais de negociação:

• Criar e gerenciar ofertas de negociação no DEX nativo do XRPL
• Monitorar livros de ordens para execução ideal de negociações
• Acompanhar ofertas ativas e desempenho do portfólio
• Executar estratégias de criação de mercado com gerenciamento automatizado de ofertas

Ferramentas Disponíveis (15 Ferramentas)

Operações Principais da Carteira

Nome da Ferramenta	Descrição	Exemplo de Uso
xrpl_get_wallet_address	Recupere o endereço da sua carteira	"Qual é o meu endereço de carteira?"
xrpl_get_account_info	Obtenha informações detalhadas da conta	"Mostre os detalhes da minha conta"
xrpl_get_balances	Obtenha todos os saldos de tokens	"Mostre meus saldos de tokens"
xrpl_send_payment	Envie XRP ou tokens para outro endereço	"Envie 100 XRP para rAddress..."

Gerenciamento de Tokens

Nome da Ferramenta	Descrição	Exemplo de Uso
xrpl_create_token	Crie um novo token com configurações personalizadas	"Crie um token com símbolo USD e exija autorização"
xrpl_set_trust_line	Defina linha de confiança para um token	"Defina linha de confiança para token USD do emissor rIssuer..."

Operações NFToken

Nome da Ferramenta	Descrição	Exemplo de Uso
xrpl_mint_nftoken	Cunhe um novo NFToken	"Cunhe um NFT com URI https://metadata.com/1"
xrpl_burn_nftoken	Queime um NFToken existente	"Queime NFToken com ID 0xABC..."

Negociação DEX

Nome da Ferramenta	Descrição	Exemplo de Uso
xrpl_create_offer	Crie uma oferta de negociação	"Crie oferta para vender 1000 USD por 500 XRP"
xrpl_cancel_offer	Cancele uma oferta existente	"Cancele minha oferta com sequência 123"
xrpl_get_order_book	Obtenha livro de ordens para par de negociação	"Mostre livro de ordens USD/XRP"
xrpl_get_account_offers	Obtenha todas as ofertas ativas da conta	"Mostre minhas ofertas de negociação ativas"

Gerenciamento de Transações

Nome da Ferramenta	Descrição	Exemplo de Uso
xrpl_get_transaction	Obtenha informações detalhadas da transação	"Mostre detalhes da transação 0xABC..."
xrpl_get_recent_transactions	Obtenha transações recentes com análises	"Mostre minhas últimas 20 transações"

Exemplos Avançados de Fluxo de Trabalho XRPL

Estratégia Completa de Emissão de Tokens

User: "Help me create and distribute a new token for my business"

Agent: 
1. Uses xrpl_create_token to create token with proper compliance settings
2. Uses xrpl_set_trust_line to establish initial trust relationships
3. Uses xrpl_send_payment to distribute tokens to holders
4. Provides ongoing monitoring and management recommendations

Gerenciamento de Coleção de NFTs

User: "I want to create and manage an NFT collection with royalties"

Agent:
1. Uses xrpl_mint_nftoken to create NFTs with transfer fees
2. Uses xrpl_get_account_info to monitor collection status
3. Tracks secondary sales and royalty collection
4. Provides collection analytics and optimization strategies

Criação de Mercado DEX

User: "Set up market making for my token on XRPL DEX"

Agent:
1. Uses xrpl_get_order_book to analyze current market conditions
2. Uses xrpl_create_offer to place buy and sell orders
3. Uses xrpl_get_account_offers to monitor active positions
4. Automatically adjusts spreads based on market activity

Análise de Transações

User: "Analyze my recent XRPL activity and optimize my operations"

Agent:
1. Uses xrpl_get_recent_transactions to fetch detailed history
2. Uses xrpl_get_transaction for in-depth analysis of each transaction
3. Analyzes fee patterns and provides optimization strategies
4. Shows token usage and trading efficiency metrics

Contexto

O Model Context Protocol (MCP), introduzido pela Claude AI no final de 2024, resolve o desafio de aplicações de IA em rápida evolução no setor de criptomoedas. Diferentemente dos kits de agentes tradicionais que acoplam fortemente modelos de IA e componentes, o MCP fornece interfaces padronizadas que permanecem estáveis à medida que os modelos evoluem.

O XRPL MCP aproveita essa arquitetura para fornecer ferramentas de blockchain de nível profissional que funcionam perfeitamente em diferentes interfaces de IA, permitindo que os usuários gerenciem operações complexas do XRPL por meio de interações em linguagem natural.

Solução de Problemas

Se você estiver usando Ubuntu ou outro ambiente Linux com NVM, precisará configurar o caminho manualmente. Siga estas etapas:

1. Instale o XRPL MCP sob a versão atual do Node.js gerenciada pelo NVM.

npm install -g @tamago-labs/xrpl-mcp

2. Devido à forma como o NVM instala bibliotecas, talvez seja necessário usar caminhos absolutos na sua configuração. Substitua os valores de exemplo abaixo pelo seu nome de usuário e versão do Node reais:

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY",
        "--xrpl_network=mainnet"
      ]
    }
  }
}

3. Reinicie o Claude Desktop e agora deve funcionar.

Licença

Este projeto é licenciado sob a Licença MIT.