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 安装

您还可以直接从 PyPI 安装 TON MCP 服务器：

pip install ton-mcp-server

使用 Docker

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

示例：将 TON MCP 服务器与 Claude Desktop 结合使用

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

Claude桌面配置示例

要将此 MCP 服务器与 Claude Desktop 一起使用，请将以下内容添加到您的 Claude Desktop 配置中：

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

{
  "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 的余额是多少……？”
“查找最近一小时的热门交易对”
“分析这个钱包的交易模式”
“显示地址 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，则可选择执行深度取证分析。用于查询账户概览、持仓或活动信息。

参数：

address （str）：要分析的 TON 地址
deep_analysis （bool，可选）：启用深度取证分析

获取交易详情

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

参数：

tx_hash （str）：交易哈希

查找热门趋势

查找 TON 区块链上特定时间范围和类别的热门代币、资金池或账户。用于查询 TON 上哪些内容热门、流行或受欢迎。

参数：

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

分析交易模式

分析指定时间段内 TON 地址的交易模式。用于查询账户的交易活动、频率、Jetton 转账或 DEX 兑换情况。

参数：

address （str）：TON 地址
timeframe （str，可选）：时间段（例如 24 小时）

获取吨价

获取指定货币（默认值：美元）的当前 TON 实时价格及近期价格变动。如果您需要获取最新的 TON 价格进行计算、分析或报告，请使用此工具。

参数：

currency （str，可选）：获取 TON 价格的法定货币或加密货币（默认值：'usd'）。

获取 Jetton 价格

获取指定币种 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