TON BLOCKCHAIN MCP

TON BLOCKCHAIN MCP

Un servidor de Model Context Protocol (MCP) para interacción en lenguaje natural con la TON blockchain.

Características

• Procesamiento de Lenguaje Natural: Comprende consultas complejas sobre blockchain en inglés sencillo
• Análisis de Trading: Analiza patrones de trading, rentabilidad y estrategias
• Detección de Tendencias Calientes: Encuentra tokens en tendencia, pools activos y cuentas de alta actividad
• Forense y Cumplimiento: Realiza investigaciones de blockchain y verificaciones de cumplimiento
• Datos en Tiempo Real: Accede a datos en vivo de la TON blockchain a través de TON API

Inicio Rápido

Requisitos Previos

• Python 3.10+
• Clave de API de TON de TONAPI

Configuración del Entorno (.env)

Para proporcionar de forma segura configuración sensible (como tu clave de API de TON), crea un archivo .env en el directorio raíz del proyecto. Este archivo se cargará automáticamente si está presente.

Ejemplo de archivo .env:

TON_API_KEY=YOUR_TON_API_KEY

Instalación

1. Clona el repositorio:

git clone https://github.com/devonmojito/ton-blockchain-mcp.git
cd ton-blockchain-mcp

2. Instala las dependencias:

pip install -r requirements.txt

---

Usando el Servidor TON MCP con Claude Desktop

Puedes usar fácilmente este servidor MCP con Claude Desktop para consultas de blockchain en lenguaje natural. A continuación se muestran algunos ejemplos de casos de uso:

Ejemplo de Detección de Estafas:

Ejemplo de Análisis de Dirección:

Ejemplo de Obtención de Detalles de Transacción:

Ejemplo de Análisis de Patrones de Trading:

Ejemplo de Configuración de Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrega lo siguiente a tu configuración de Claude Desktop:

• Es posible que necesites reemplazar la configuración del entorno de Python con la tuya propia.

{
    "mcpServers":
    {
        "ton-mcp-server":
        {
            "command": "/Users/devon/ton-mcp/ton-blockchain-mcp/venv/bin/python",
            "args":
            [
                "-m",
                "tonmcp.mcp_server"
            ],
            "cwd": "/Users/devon/ton-mcp/ton-blockchain-mcp/src",
            "env":
            {
                "PYTHONPATH": "/Users/devon/ton-mcp/ton-blockchain-mcp/src"
            },
            "stdio": true
        }
    }
}

---

Ejemplos de Lenguaje Natural

• "¿Cuál es el saldo de la dirección EQD1234...?"
• "Encuentra pares de trading calientes en la última hora"
• "Analiza patrones de trading para esta billetera"
• "Muestra actividad sospechosa para la dirección ABC"
• "Rastrea el flujo de dinero desde esta dirección"

Documentación de Herramientas MCP y Prompts del Sistema

Herramientas

analyze_address

Analiza una dirección de TON para su saldo, tenencias de jetton, NFTs y actividad reciente. Opcionalmente realiza un análisis forense profundo si deep_analysis es True. Úsalo para preguntas sobre resumen de cuenta, tenencias o actividad.

Parámetros:

• address (str): Dirección de TON a analizar
• deep_analysis (bool, opcional): Habilita el análisis forense profundo

get_transaction_details

Obtén detalles y análisis de una transacción específica de la TON blockchain mediante su hash. Úsalo para preguntas sobre una transacción particular, sus participantes, valor o tipo.

Parámetros:

• tx_hash (str): Hash de la transacción

find_hot_trends

Encuentra tokens, pools o cuentas en tendencia en la TON blockchain para un período de tiempo y categoría dados. Úsalo para preguntas sobre qué está caliente, en tendencia o popular en TON.

Parámetros:

• timeframe (str, opcional): Período de tiempo (ej., 1h, 24h, 7d)
• category (str, opcional): Tipo de tendencias (tokens, pools, cuentas)

analyze_trading_patterns

Analiza patrones de trading para una dirección de TON en un período de tiempo especificado. Úsalo para preguntas sobre actividad de trading, frecuencia, transferencias de jetton o swaps en DEX para una cuenta.

Parámetros:

• address (str): Dirección de TON
• timeframe (str, opcional): Período de tiempo (ej., 24h)

get_ton_price

Obtén el precio actual en tiempo real de TON en la moneda especificada (por defecto: USD) y los cambios recientes de precio. Usa esta herramienta siempre que necesites el último precio de TON para cálculos, análisis o informes.

Parámetros:

• currency (str, opcional): La moneda fiduciaria o cripto para obtener el precio de TON (por defecto: 'usd').

get_jetton_price

Obtén el precio actual y los cambios recientes de tokens jetton especificados (no TON) en la moneda dada. Proporciona una lista de direcciones maestras de jetton como tokens. Usa esta herramienta para obtener precios en tiempo real de cualquier token excepto TON.

Parámetros:

• tokens (lista de str): Lista de direcciones maestras de jetton para obtener precios (excluyendo 'ton').
• currency (str, opcional): La moneda fiduciaria o cripto para obtener el precio (por defecto: 'usd').

Prompts del Sistema

• trading_analysis: Genera prompts de análisis de trading
• forensics_investigation: Genera prompts de forense
• trend_analysis: Genera prompts de análisis de tendencias

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Realiza tus cambios
4. Haz push a la rama
5. Crea un Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.

Soporte

Para soporte, por favor abre un issue en GitHub

⚠️ ADVERTENCIA: Este proyecto está en Beta. No confíes en ningún número proporcionado por el modelo LLM. Nada en este proyecto constituye asesoramiento financiero. Úsalo bajo tu propio riesgo.