TON Blockchain MCP

TONELADA BLOCKCHAIN MCP

Un servidor de Protocolo de Contexto Modelo (MCP) para la interacción en lenguaje natural con la cadena de bloques TON .

Características

• Procesamiento del lenguaje natural : comprenda consultas complejas de blockchain en un lenguaje sencillo
• Análisis comercial : Analice patrones comerciales, rentabilidad y estrategias.
• Detección de tendencias actuales : encuentre tokens de tendencia, grupos activos y cuentas con alta actividad.
• Análisis forense y cumplimiento : Realice investigaciones de blockchain y controles de cumplimiento.
• Datos en tiempo real : acceda a datos de la cadena de bloques TON en vivo a través de la API TON

Inicio rápido

Prerrequisitos

• Python 3.10+
• Clave API de TON de TONAPI

Configuración del entorno (.env)

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

Ejemplo de archivo .env :

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

Uso del servidor TON MCP con Claude Desktop

Puedes usar fácilmente este servidor MCP con Claude Desktop para realizar consultas de blockchain en lenguaje natural. A continuación, se muestran algunos ejemplos 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 comerciales:

Ejemplo de configuración de escritorio de Claude

Para utilizar este servidor MCP con Claude Desktop, agregue lo siguiente a su configuración de Claude Desktop:

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

Ejemplos de lenguaje natural

• "¿Cuál es el saldo de la dirección EQD1234...?"
• Encuentra pares de trading en auge en la última hora.
• Analizar los patrones de trading de esta billetera.
• "Mostrar actividad sospechosa para la dirección ABC"
• Rastrear el flujo de dinero desde esta dirección

Documentación de herramientas y avisos del sistema de MCP

Herramientas

analizar_dirección

Analiza una dirección TON para conocer su saldo, activos de Jetton, NFT y actividad reciente. Opcionalmente, realiza un análisis forense profundo si deep_analysis es verdadero. Úselo para preguntas sobre la descripción general de la cuenta, activos o actividad.

Parámetros:

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

obtener_detalles_de_la_transacción

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

Parámetros:

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

encontrar tendencias actuales

Encuentra tokens, pools o cuentas de tendencia en la blockchain de TON para un período y categoría determinados. Úsalo para preguntas sobre lo que está de moda, es tendencia o es popular en TON.

Parámetros:

• timeframe (str, opcional): período de tiempo (por ejemplo, 1 h, 24 h, 7 d)
• category (str, opcional): Tipo de tendencias (tokens, pools, cuentas)

analizar_patrones_comerciales

Analice los patrones de trading de una dirección TON durante un período específico. Úselo para preguntas sobre la actividad de trading, la frecuencia, las transferencias de Jetton o los swaps DEX de una cuenta.

Parámetros:

• address (str): dirección TON
• timeframe (str, opcional): período de tiempo (por ejemplo, 24 h)

obtener_precio_tonelada

Obtenga el precio actual de TON en tiempo real en la moneda especificada (predeterminado: USD) y las variaciones recientes. Utilice esta herramienta siempre que necesite el precio más reciente de TON para cálculos, análisis o informes.

Parámetros:

• currency (str, opcional): la moneda fiduciaria o criptográfica en la que obtener el precio de TON (predeterminado: 'usd').

obtener_precio_jetton

Obtenga el precio actual y los cambios recientes de los tokens jetton especificados (no TON) en la moneda dada. Proporcione una lista de direcciones maestras de jetton como tokens. Use 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 criptográfica en la que obtener el precio (predeterminado: 'usd').

Avisos del sistema

• trading_analysis : Generar indicaciones de análisis comercial
• forensics_investigation : Generar indicaciones forenses
• trend_analysis : Generar indicaciones de análisis de tendencias

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Confirme sus cambios
4. Empujar hacia la rama
5. Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

Para obtener ayuda, abra un problema en GitHub

⚠️ ADVERTENCIA: Este proyecto está en fase beta. No confíe en las cifras proporcionadas por el modelo LLM. Nada de lo contenido en este proyecto constituye asesoramiento financiero. Úselo bajo su propio riesgo.