TONブロックチェーンMCP

TON ブロックチェーンとの自然言語対話のためのモデルコンテキストプロトコル (MCP) サーバー。

特徴

• 自然言語処理：複雑なブロックチェーンクエリを平易な英語で理解する

• 取引分析：取引パターン、収益性、戦略を分析する

• ホットトレンド検出: トレンドのトークン、アクティブなプール、アクティビティの高いアカウントを見つける

• フォレンジックとコンプライアンス：ブロックチェーンの調査とコンプライアンスチェックを実施

• リアルタイムデータ:TON APIを通じてライブTONブロックチェーンデータにアクセス

Related MCP server: Flow MCP Server

クイックスタート

前提条件

• Python 3.10以上

• TONAPIからの TON API キー

環境設定 (.env)

機密性の高い設定（TON APIキーなど）を安全に提供するには、プロジェクトのルートディレクトリに.envファイルを作成してください。このファイルは存在する場合、自動的に読み込まれます。

.envファイルの例:

TON_API_KEY=YOUR_TON_API_KEY

インストール

1. リポジトリをクローンします。

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

2. 依存関係をインストールします:

pip install -r requirements.txt

Claude DesktopでTON MCPサーバーを使用する

このMCPサーバーは、Claude Desktopと連携して自然言語によるブロックチェーンクエリを簡単に実行できます。以下にユースケースの例を示します。

詐欺検出の例:

アドレス分析の例:

トランザクションの詳細を取得する例:

取引パターンの分析例:

クロードデスクトップの構成例

この MCP サーバーを Claude Desktop で使用するには、Claude Desktop の設定に以下を追加します。

• Python env セットアップを独自のものに置き換える必要があるかもしれません。

{
    "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
        }
    }
}

自然言語の例

• 「アドレスEQD1234の残高はいくらですか…？」

• 「過去1時間のホットな取引ペアを見つける」

• 「このウォレットの取引パターンを分析する」

• 「アドレスABCの不審なアクティビティを表示する」

• 「このアドレスからの資金の流れを追跡する」

MCP ツールとシステムプロンプトのドキュメント

ツール

分析アドレス

TONアドレスの残高、Jetton保有資産、NFT、最近のアクティビティを分析します。deep_analysisがTrueの場合、オプションで詳細なフォレンジック分析を実行します。アカウントのdeep_analysis 、保有資産、アクティビティに関する質問に使用します。

パラメータ:

• address (str): 分析するTONアドレス

• deep_analysis (bool, オプション): 詳細なフォレンジック分析を有効にする

トランザクションの詳細を取得する

特定のTONブロックチェーントランザクションの詳細と分析をハッシュで取得します。特定のトランザクション、その参加者、値、または種類に関する質問に使用できます。

パラメータ:

• tx_hash (str): トランザクションハッシュ

ホットトレンドを見つける

TONブロックチェーン上で、特定の期間とカテゴリーでトレンドになっているトークン、プール、またはアカウントを検索します。TONで何がホットか、トレンドになっているか、人気のあるかといった質問にご利用いただけます。

パラメータ:

• timeframe (文字列、オプション): 期間 (例: 1時間、24時間、7日)

• category (str, オプション): トレンドの種類 (トークン、プール、アカウント)

取引パターンを分析する

特定の期間におけるTONアドレスの取引パターンを分析します。アカウントの取引活動、頻度、Jetton送金、DEXスワップに関する質問に使用できます。

パラメータ:

• address (str): TON アドレス

• timeframe (文字列、オプション): 期間 (例: 24 時間)

トン価格を取得する

指定した通貨（デフォルト：USD）でのTONのリアルタイム価格と最近の価格変動を取得します。計算、分析、レポート作成などで最新のTON価格が必要な場合は、このツールをご利用ください。

パラメータ:

• currency (str, オプション): TON 価格を取得する法定通貨または暗号通貨 (デフォルト: 'usd')。

ジェットンの価格を取得する

指定した通貨で、指定したJettonトークン（TON以外）の現在の価格と最近の変動を取得します。トークンとしてJettonマスターアドレスのリストを提供してください。このツールを使用すると、TON以外のトークンのリアルタイム価格を取得できます。

パラメータ:

• tokens (str のリスト): 価格を取得する jetton マスター アドレスのリスト ('ton' を除く)。

• currency (str, オプション): 価格を取得する法定通貨または暗号通貨 (デフォルト: 'usd')。

システムプロンプト

• trading_analysis : 取引分析プロンプトを生成する

• forensics_investigation : フォレンジックプロンプトを生成する

• trend_analysis : トレンド分析プロンプトを生成する

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

サポート

サポートについては、GitHub で問題を報告してください。

⚠️ 警告：このプロジェクトはベータ版です。LLMモデルが提供する数値を信用しないでください。このプロジェクトのいかなる内容も金融アドバイスに該当するものではありません。自己責任でご利用ください。