Cryptocurrency Daemon

Um servidor MCP para interagir com interfaces RPC de daemon de criptomoeda.

Documentação

Servidor MCP Cryptocurrency Daemon (BETA)

Um servidor Model Context Protocol (MCP) para interagir com interfaces RPC de daemons de criptomoedas. Este servidor permite que assistentes de IA ajudem a gerenciar e interagir com nós de criptomoedas de forma controlada.

⚠️ AVISO IMPORTANTE DE SEGURANÇA ⚠️

Este software permite que sistemas de IA interajam com daemons de criptomoedas. Leia este aviso com atenção:

Executar este servidor MCP dá aos sistemas de IA a capacidade de:
- Enviar transações
- Acessar informações de carteiras
- Modificar configurações de carteiras
- Visualizar dados privados
- Executar comandos do daemon
Os riscos potenciais incluem:
- Perda de fundos por meio de transações não autorizadas
- Exposição de informações privadas
- Modificações não intencionais em carteiras ou daemons
- Possíveis vulnerabilidades de segurança se configurado incorretamente
Medidas de segurança necessárias:
- Use uma carteira separada com fundos limitados para interações com IA
- Nunca dê acesso a carteiras que contenham valores significativos
- Configure permissões RPC estritas
- Monitore todas as interações da IA com o daemon
- Realize auditorias de segurança regulares das configurações
- Mantenha backups de todos os dados importantes

Este software está em BETA. Use por sua conta e risco.

Instalação

Instalando via Smithery

Para instalar o Cryptocurrency Daemon Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @raw391/coin_daemon_mcp --client claude

1. Instale o Pacote

Você pode instalar o pacote via npm:

npm install @raw391/coin-daemon-mcp

2. Configure o Claude Desktop

Para usar este MCP com o Claude Desktop, você precisará modificar sua configuração do Claude Desktop. O arquivo de configuração está localizado em:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Adicione o seguinte à sua configuração:

{
  "mcpServers": {
    "cryptocurrency": {
      "command": "npx",
      "args": [
      "-y",
        "@raw391/coin-daemon-mcp"
      ],
      "env": {
        "CONFIG_PATH": "path/to/your/config.json"
      }
    }
  }
}

3. Crie o Arquivo de Configuração

Crie um arquivo de configuração para seus daemons de criptomoedas. Aqui estão alguns exemplos de configuração:

Configuração Básica de Daemon Único

{
  "daemons": [
    {
      "coinName": "zcash",
      "nickname": "zec-main",
      "rpcEndpoint": "127.0.0.1:8232",
      "rpcUser": "your-rpc-user",
      "rpcPassword": "your-rpc-password"
    }
  ]
}

Configuração de Múltiplos Daemons

{
  "daemons": [
    {
      "coinName": "zcash",
      "nickname": "zec-main",
      "rpcEndpoint": "127.0.0.1:8232",
      "rpcUser": "zec-user",
      "rpcPassword": "zec-password"
    },
    {
      "coinName": "bitcoin",
      "nickname": "btc-main",
      "rpcEndpoint": "127.0.0.1:8332",
      "rpcUser": "btc-user",
      "rpcPassword": "btc-password"
    }
  ]
}

Configuração Avançada com Diretório de Dados

Para melhores práticas de segurança, você pode querer também usar um MCP de sistema de arquivos para gerenciar os dados do daemon. Veja como configurar ambos juntos:

{
  "mcpServers": {
    "cryptocurrency": {
      "command": "npx",
      "args": [
        "-y",
        "@raw391/coin-daemon-mcp"
      ],
      "env": {
        "CONFIG_PATH": "C:/CryptoConfig/daemon-config.json"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/CryptoData"
      ]
    }
  }
}

4. Configure Seu Daemon de Criptomoeda

Certifique-se de que o arquivo de configuração do seu daemon de criptomoeda (por exemplo, zcash.conf, bitcoin.conf) tenha as configurações RPC apropriadas:

server=1
rpcuser=your-rpc-user
rpcpassword=your-rpc-password
rpcallowip=127.0.0.1

5. Comece a Usar o MCP

Após a configuração, reinicie o Claude Desktop. Você deve ver novas ferramentas, recursos e prompts disponíveis para:

Enviar transações
Verificar saldos
Gerenciar carteiras
Monitorar o status do daemon
Aprender sobre criptomoedas
E muito mais

Recursos do MCP

O servidor fornece três tipos de capacidades MCP:

Ferramentas

Gerenciamento de Transações
- send-coins: Enviar transações transparentes
- zsend-coins: Enviar transações protegidas (para moedas de privacidade)
- shield-coins: Converter fundos transparentes em protegidos
Operações de Carteira
- get-balance: Verificar saldos
- execute-command: Executar qualquer comando RPC suportado
Gerenciamento de Daemon
- check-status: Obter informações do daemon

Recursos

Acesse dados valiosos e documentação:

Recursos de Documentação
- crypto://{coinType}/help: Obter documentação detalhada para criptomoedas específicas
- daemon://{name}/help: Obter texto de ajuda específico para um daemon
Histórico de Transações
- daemon://{name}/transactions: Visualizar histórico recente de transações

Prompts

Modelos pré-construídos para fluxos de trabalho comuns:

Orientação de Transações
- send-transaction-template: Gerar um prompt guiado para construir transações
Modelos de Análise
- balance-analysis: Analisar saldos de carteira e distribuição de fundos
- daemon-diagnostic: Realizar uma verificação de saúde de um daemon

Melhores Práticas de Segurança

Carteiras Separadas
- Crie carteiras dedicadas para interações com IA
- Mantenha fundos mínimos em carteiras acessíveis
- Use redes de teste para desenvolvimento
Segurança RPC
- Use credenciais RPC fortes e únicas
- Habilite apenas comandos RPC necessários
- Restrinja o acesso RPC ao localhost
- Monitore os logs RPC
Gerenciamento de Dados
- Backups regulares de carteiras
- Armazenamento seguro de arquivos de configuração
- Monitoramento de todas as transações
- Auditorias de segurança regulares

Exemplo de Uso

Veja como o Claude pode ajudar com tarefas comuns:

Verificando Status: "Qual é o status atual do daemon Zcash?"
Gerenciando Saldos: "Qual é meu saldo atual em todos os endereços?"
Aprendendo Sobre Criptomoedas: "Você pode explicar como funcionam as transações protegidas do Zcash?"
Enviando Transações: "Você pode me ajudar a enviar 0,1 ZEC para o endereço xxx?"

Solução de Problemas

Problemas de Conexão
- Verifique se o daemon está em execução
- Verifique as credenciais RPC
- Certifique-se de que os números de porta estão corretos
- Verifique o acesso ao localhost
Problemas de Permissão
- Verifique as permissões de arquivo
- Verifique os direitos do usuário RPC
- Certifique-se de que os caminhos de configuração estão corretos
Problemas de Transação
- Verifique se há fundos suficientes
- Verifique a conectividade de rede
- Certifique-se de que o daemon está sincronizado

Suporte

Issues no GitHub: Relatórios de bugs e solicitações de recursos
Discussões: Perguntas gerais e suporte da comunidade
Problemas de Segurança: Envie e-mail para security@pooly.ca

Licença

Licença MIT com aviso adicional sobre operações de criptomoedas. Consulte LICENSE para detalhes.

Contribuição

Consulte CONTRIBUTING.md para diretrizes de contribuição.