Cryptocurrency Daemon

Un servidor MCP para interactuar con interfaces RPC de demonios de criptomonedas.

Documentación

Servidor MCP de Cryptocurrency Daemon (BETA)

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con interfaces RPC de daemons de criptomonedas. Este servidor permite a los asistentes de IA ayudar a gestionar e interactuar con nodos de criptomonedas de manera controlada.

⚠️ ADVERTENCIA DE SEGURIDAD IMPORTANTE ⚠️

Este software permite que los sistemas de IA interactúen con daemons de criptomonedas. Lea esta advertencia cuidadosamente:

Ejecutar este servidor MCP otorga a los sistemas de IA la capacidad de:
- Enviar transacciones
- Acceder a información de billeteras
- Modificar configuraciones de billeteras
- Ver datos privados
- Ejecutar comandos del daemon
Los riesgos potenciales incluyen:
- Pérdida de fondos a través de transacciones no autorizadas
- Exposición de información privada
- Modificaciones no deseadas en billeteras o daemons
- Posibles vulnerabilidades de seguridad si se configura incorrectamente
Medidas de seguridad requeridas:
- Use una billetera separada con fondos limitados para interacciones con IA
- Nunca otorgue acceso a billeteras que contengan valor significativo
- Configure permisos RPC estrictos
- Supervise todas las interacciones de IA con el daemon
- Realice auditorías de seguridad periódicas de las configuraciones
- Mantenga copias de seguridad de todos los datos importantes

Este software está en BETA. Úselo bajo su propio riesgo.

Instalación

Instalación mediante Smithery

Para instalar Cryptocurrency Daemon Server para Claude Desktop automáticamente mediante Smithery:

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

1. Instale el Paquete

Puede instalar el paquete mediante npm:

npm install @raw391/coin-daemon-mcp

2. Configure Claude Desktop

Para usar este MCP con Claude Desktop, deberá modificar su configuración de Claude Desktop. El archivo de configuración se encuentra en:

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

Agregue lo siguiente a su configuración:

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

3. Cree el Archivo de Configuración

Cree un archivo de configuración para sus daemons de criptomonedas. Aquí hay algunos ejemplos de configuración:

Configuración Básica de un Solo Daemon

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

Configuración de Múltiples 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"
    }
  ]
}

Configuración Avanzada con Directorio de Datos

Para las mejores prácticas de seguridad, es posible que también desee usar un MCP de sistema de archivos para gestionar los datos del daemon. Así es como se configuran 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 Su Daemon de Criptomonedas

Asegúrese de que el archivo de configuración de su daemon de criptomonedas (por ejemplo, zcash.conf, bitcoin.conf) tenga la configuración RPC adecuada:

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

5. Comience a Usar el MCP

Después de la configuración, reinicie Claude Desktop. Debería ver nuevas herramientas, recursos y avisos disponibles para:

Enviar transacciones
Consultar saldos
Gestionar billeteras
Monitorear el estado del daemon
Aprender sobre criptomonedas
Y más

Características del MCP

El servidor proporciona tres tipos de capacidades MCP:

Herramientas

Gestión de Transacciones
- send-coins: Enviar transacciones transparentes
- zsend-coins: Enviar transacciones blindadas (para monedas de privacidad)
- shield-coins: Convertir fondos transparentes a blindados
Operaciones de Billetera
- get-balance: Consultar saldos
- execute-command: Ejecutar cualquier comando RPC compatible
Gestión del Daemon
- check-status: Obtener información del daemon

Recursos

Acceda a datos valiosos y documentación:

Recursos de Documentación
- crypto://{coinType}/help: Obtener documentación detallada para criptomonedas específicas
- daemon://{name}/help: Obtener texto de ayuda específico para un daemon
Historial de Transacciones
- daemon://{name}/transactions: Ver el historial reciente de transacciones

Avisos

Plantillas preconstruidas para flujos de trabajo comunes:

Guía de Transacciones
- send-transaction-template: Generar un aviso guiado para construir transacciones
Plantillas de Análisis
- balance-analysis: Analizar saldos de billetera y distribución de fondos
- daemon-diagnostic: Realizar una verificación de salud de un daemon

Mejores Prácticas de Seguridad

Billeteras Separadas
- Cree billeteras dedicadas para interacciones con IA
- Mantenga fondos mínimos en billeteras accesibles
- Use redes de prueba para desarrollo
Seguridad RPC
- Use credenciales RPC fuertes y únicas
- Habilite solo los comandos RPC necesarios
- Restrinja el acceso RPC a localhost
- Supervise los registros RPC
Gestión de Datos
- Copias de seguridad periódicas de billeteras
- Almacenamiento seguro de archivos de configuración
- Monitoreo de todas las transacciones
- Auditorías de seguridad periódicas

Ejemplo de Uso

Así es como Claude puede ayudar con tareas comunes:

Consultar el Estado: "¿Cuál es el estado actual del daemon de Zcash?"
Gestionar Saldos: "¿Cuál es mi saldo actual en todas las direcciones?"
Aprender sobre Criptomonedas: "¿Puedes explicar cómo funcionan las transacciones blindadas de Zcash?"
Enviar Transacciones: "¿Puedes ayudarme a enviar 0.1 ZEC a la dirección xxx?"

Solución de Problemas

Problemas de Conexión
- Verifique que el daemon esté ejecutándose
- Compruebe las credenciales RPC
- Asegúrese de que los números de puerto sean correctos
- Verifique el acceso a localhost
Problemas de Permisos
- Compruebe los permisos de archivos
- Verifique los derechos del usuario RPC
- Asegúrese de que las rutas de configuración sean correctas
Problemas de Transacciones
- Verifique que haya fondos suficientes
- Compruebe la conectividad de red
- Asegúrese de que el daemon esté sincronizado

Soporte

Problemas en GitHub: Informes de errores y solicitudes de funciones
Discusiones: Preguntas generales y soporte comunitario
Problemas de Seguridad: Envíe un correo a security@pooly.ca

Licencia

Licencia MIT con descargo de responsabilidad adicional sobre operaciones de criptomonedas. Consulte LICENCIA para más detalles.

Contribuciones

Consulte CONTRIBUTING.md para las pautas de contribución.