TONブロックチェーンMCP

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

特徴

自然言語処理：複雑なブロックチェーンクエリを平易な英語で理解する
取引分析：取引パターン、収益性、戦略を分析する
ホットトレンド検出: トレンドのトークン、アクティブなプール、アクティビティの高いアカウントを見つける
フォレンジックとコンプライアンス：ブロックチェーンの調査とコンプライアンスチェックを実施
リアルタイムデータ:TON APIを通じてライブTONブロックチェーンデータにアクセス

クイックスタート

前提条件

Python 3.10以上
TONAPIからの TON API キー

インストール

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

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

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

pip install -r requirements.txt

環境変数を設定します。

APIキーも.envに置くといいかもしれません

export TON_API_KEY=your_api_key_here

サーバーを実行します。

python -m src.mcp_server

PyPIのインストール

TON MCP サーバーを PyPI から直接インストールすることもできます。

pip install ton-mcp-server

Dockerの使用

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

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

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

その他のスクリーンショット例

アドレス分析の例:

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

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

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

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

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

使用法

基本的なクエリ

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())

自然言語の例

「アドレスEQD1234の残高はいくらですか…？」
「過去1時間のホットな取引ペアを見つける」
「このウォレットの取引パターンを分析する」
「アドレスABCの不審なアクティビティを表示する」
「このアドレスからの資金の流れを追跡する」

構成

構成は次の方法で提供できます。

環境変数
config/settings.jsonファイル
実行時パラメータ

主な構成オプション:

TON_API_KEY : TON APIキー
MCP_HOST : サーバーホスト (デフォルト: localhost)
MCP_PORT : サーバーポート (デフォルト: 8000)
LOG_LEVEL : ログレベル（デフォルト: INFO）

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 : トレンド分析プロンプトを生成する

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

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

サポート

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

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

TON Blockchain MCP

Integrations