TON 区块链 MCP

这是一个用于与TON 区块链进行自然语言交互的模型上下文协议（MCP）服务器。

特性

• 自然语言处理：理解用简单英语表达的复杂区块链查询
• 交易分析：分析交易模式、盈利能力及策略
• 热门趋势检测：发现热门代币、活跃池以及高活动账户
• 取证与合规：执行区块链调查及合规检查
• 实时数据：通过 TON API 访问实时 TON 区块链数据

快速开始

先决条件

• 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

---

使用 TON MCP 服务器与 Claude Desktop

您可以轻松地使用此 MCP 服务器与 Claude Desktop 进行自然语言区块链查询。以下是一些示例用例：

诈骗检测示例：

地址分析示例：

获取交易详情示例：

分析交易模式示例：

Claude Desktop 配置示例

要使用此 MCP 服务器与 Claude Desktop，需在您的 Claude Desktop 配置中添加以下内容：

• 您可能需要用自己的 Python 环境设置替换此处的设置。

{
    "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... 的余额是多少？"
• "找出过去一小时内的热门交易对"
• "分析这个钱包的交易模式"
• "显示地址 ABC 的可疑活动"
• "追踪从这个地址发出的资金流向"

MCP 工具及系统提示文档

工具

analyze_address

分析 TON 地址的余额、jetton 持有量、NFT 及最近活动。如果 deep_analysis 为 True，则可执行深入的取证分析。适用于关于账户概览、持有量或活动的问题。

参数：

• address (str): 要分析的 TON 地址
• deep_analysis (bool, 可选): 启用深入的取证分析

get_transaction_details

根据其哈希值获取特定 TON 区块链交易的详细信息及分析。适用于关于特定交易、参与者、价值或类型的问题。

参数：

• tx_hash (str): 交易哈希

find_hot_trends

查找给定时间段和类别下的 TON 区块链上的热门代币、池或账户。适用于关于 TON 上什么热门、趋势或受欢迎的问题。

参数：

• timeframe (str, 可选): 时间段（例如，1h, 24h, 7d）
• category (str, 可选): 趋势类型（代币、池、账户）

analyze_trading_patterns

分析 TON 地址在指定时间段内的交易模式。适用于关于账户的交易活动、频率、jetton 转移或 DEX 交换的问题。

参数：

• address (str): TON 地址
• timeframe (str, 可选): 时间段（例如，24h）

get_ton_price

获取当前实时 TON 价格及其最近的价格变化（默认货币单位：USD）。每当您需要最新的 TON 价格来进行计算、分析或报告时，请使用此工具。

参数：

• currency (str, 可选): 获取 TON 价格的法定货币或加密货币（默认：'usd'）。

get_jetton_price

获取指定 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 上打开一个 Issue

⚠️ 警告：此项目处于测试阶段。不要信任由 LLM 模型提供的任何数字。本项目中的任何内容均不构成财务建议。请自行承担风险使用。