TON Blockchain MCP

TON BLOCKCHAIN MCP

Ein Model Context Protocol (MCP)-Server für die Interaktion in natürlicher Sprache mit der TON-Blockchain .

Merkmale

Verarbeitung natürlicher Sprache : Verstehen Sie komplexe Blockchain-Abfragen in einfachem Englisch
Handelsanalyse : Analysieren Sie Handelsmuster, Rentabilität und Strategien
Erkennung aktueller Trends : Finden Sie trendige Token, aktive Pools und Konten mit hoher Aktivität
Forensik und Compliance : Führen Sie Blockchain-Untersuchungen und Compliance-Prüfungen durch
Echtzeitdaten : Zugriff auf Live-TON-Blockchain-Daten über die TON-API

Schnellstart

Voraussetzungen

Python 3.10+
TON API-Schlüssel von TONAPI

Installation

Klonen Sie das Repository:

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

Installieren Sie Abhängigkeiten:

pip install -r requirements.txt

Umgebungsvariablen einrichten:

Möglicherweise möchten Sie den API-Schlüssel auch in .env einfügen

export TON_API_KEY=your_api_key_here

Führen Sie den Server aus:

python -m src.mcp_server

PyPI-Installation

Sie können den TON MCP-Server auch direkt von PyPI installieren:

pip install ton-mcp-server

Verwenden von Docker

# Build and run with Docker Compose
docker-compose up --build

Beispiel: Verwenden des TON MCP-Servers mit Claude Desktop

Sie können diesen MCP-Server problemlos mit Claude Desktop für Blockchain-Abfragen in natürlicher Sprache verwenden. Nachfolgend finden Sie einige Anwendungsbeispiele:

Weitere Beispiel-Screenshots

Beispiel für die Adressanalyse:

Beispiel für das Abrufen von Transaktionsdetails:

Claude Desktop-Konfigurationsbeispiel

Um diesen MCP-Server mit Claude Desktop zu verwenden, fügen Sie Ihrer Claude Desktop-Konfiguration Folgendes hinzu:

Möglicherweise müssen Sie das Python-Umgebungs-Setup durch Ihr eigenes ersetzen.

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

Verwendung

Grundlegende Abfragen

import asyncio
from mcp_client import McpClient

async def main():
    client = McpClient("http://localhost:8000")
    
    # Analyze an address
    result = await client.call_tool("analyze_address", {
        "address": "EQD1234...",
        "deep_analysis": True
    })
    print(result)

asyncio.run(main())

Beispiele für natürliche Sprache

„Wie hoch ist der Saldo der Adresse EQD1234…?“
„Finden Sie heiße Handelspaare in der letzten Stunde“
„Handelsmuster für diese Brieftasche analysieren“
„Verdächtige Aktivitäten für Adresse ABC anzeigen“
„Geldfluss von dieser Adresse verfolgen“

Konfiguration

Die Konfiguration kann bereitgestellt werden über:

Umgebungsvariablen
Datei config/settings.json
Laufzeitparameter

Wichtige Konfigurationsoptionen:

TON_API_KEY : Ihr TON-API-Schlüssel
MCP_HOST : Server-Host (Standard: localhost)
MCP_PORT : Server-Port (Standard: 8000)
LOG_LEVEL : Protokollierungsebene (Standard: INFO)

Dokumentation zu MCP-Tools und Systemeingabeaufforderungen

Werkzeuge

Adresse analysieren

Analysieren Sie eine TON-Adresse hinsichtlich Kontostand, Jetton-Beständen, NFTs und aktueller Aktivitäten. Führt optional eine gründliche forensische Analyse durch, wenn deep_analysis auf „True“ gesetzt ist. Verwenden Sie diese Option für Fragen zur Kontoübersicht, zu Beständen oder Aktivitäten.

Parameter:

address (str): Zu analysierende TON-Adresse
deep_analysis (bool, optional): Aktivieren Sie eine gründliche forensische Analyse

get_transaction_details

Erhalten Sie Details und Analysen zu einer bestimmten TON-Blockchain-Transaktion anhand ihres Hashs. Nutzen Sie diese Funktion für Fragen zu einer bestimmten Transaktion, ihren Teilnehmern, ihrem Wert oder ihrem Typ.

Parameter:

tx_hash (str): Transaktions-Hash

heiße_trends finden

Finden Sie trendige Token, Pools oder Konten in der TON-Blockchain für einen bestimmten Zeitraum und eine bestimmte Kategorie. Nutzen Sie diese Funktion für Fragen zu aktuellen, trendigen oder beliebten Themen auf TON.

Parameter:

timeframe (str, optional): Zeitraum (z. B. 1 Std., 24 Std., 7 d)
category (str, optional): Art der Trends (Token, Pools, Konten)

Handelsmuster analysieren

Analysieren Sie Handelsmuster für eine TON-Adresse über einen bestimmten Zeitraum. Nutzen Sie diese Funktion für Fragen zu Handelsaktivität, Häufigkeit, Jetton-Transfers oder DEX-Swaps für ein Konto.

Parameter:

address (str): TON-Adresse
timeframe (str, optional): Zeitraum (z. B. 24 Stunden)

get_ton_price

Erhalten Sie den aktuellen TON-Preis in Echtzeit in der angegebenen Währung (Standard: USD) sowie aktuelle Preisänderungen. Nutzen Sie dieses Tool, wenn Sie den aktuellen TON-Preis für Berechnungen, Analysen oder Berichte benötigen.

Parameter:

currency (str, optional): Die Fiat- oder Kryptowährung, in der der TON-Preis abgerufen werden soll (Standard: „usd“).

get_jetton_price

Erhalten Sie den aktuellen Preis und die letzten Änderungen für bestimmte Jetton-Token (nicht TON) in der angegebenen Währung. Stellen Sie eine Liste der Jetton-Masteradressen als Token bereit. Mit diesem Tool können Sie Echtzeitpreise für alle Token außer TON abrufen.

Parameter:

tokens (Liste von str): Liste der Jetton-Masteradressen, für die Preise abgerufen werden sollen (ausgenommen „ton“).
currency (str, optional): Die Fiat- oder Kryptowährung, in der der Preis abgerufen werden soll (Standard: „usd“).

Systemaufforderungen

trading_analysis : Eingabeaufforderungen für Handelsanalysen generieren
forensics_investigation : Forensische Eingabeaufforderungen generieren
trend_analysis : Eingabeaufforderungen zur Trendanalyse generieren

Beitragen

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Push zum Zweig
Erstellen einer Pull-Anforderung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Unterstützung

Für Support öffnen Sie bitte ein Problem auf GitHub

⚠️ WARNUNG: Dieses Projekt befindet sich in der Betaphase. Vertrauen Sie keinen Zahlen des LLM-Modells. Dieses Projekt stellt keine Finanzberatung dar. Die Nutzung erfolgt auf eigene Gefahr.

TON Blockchain MCP

Integrations