TON Blockchain MCP

by devonmojito

Integrations

  • Utilizes environment variables for configuration with option to store the TON API key in a .env file.

  • Supports containerized deployment through Docker Compose with provided configuration for building and running the MCP server.

  • Provides repository access and issue tracking for support requests, with instructions for cloning the repository hosted on GitHub.

TON БЛОКЧЕЙН MCP

Сервер протокола контекста модели (MCP) для взаимодействия на естественном языке с блокчейном TON .

Функции

  • Обработка естественного языка : понимание сложных запросов блокчейна на простом английском языке
  • Анализ торговли : анализ торговых моделей, прибыльности и стратегий.
  • Обнаружение горячих тенденций : найдите популярные токены, активные пулы и высокоактивные аккаунты.
  • Криминалистика и соответствие требованиям : проведение расследований в сфере блокчейна и проверок соответствия требованиям
  • Данные в реальном времени : доступ к данным блокчейна TON в реальном времени через API TON

Быстрый старт

Предпосылки

  • Питон 3.10+
  • Ключ API TON от TONAPI

Установка

  1. Клонируйте репозиторий:
git clone https://github.com/devonmojito/ton-blockchain-mcp.git cd ton-blockchain-mcp
  1. Установить зависимости:
pip install -r requirements.txt
  1. Настройте переменные среды:
  • Возможно, вы также захотите поместить ключ API в .env.
export TON_API_KEY=your_api_key_here
  1. Запускаем сервер:
python -m src.mcp_server

Установка PyPI

Вы также можете установить TON MCP Server непосредственно из PyPI:

pip install ton-mcp-server

Использование Докера

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

Пример: использование TON MCP Server с Claude Desktop

Вы можете легко использовать этот сервер MCP с Claude Desktop для запросов на естественном языке блокчейна. Ниже приведены некоторые примеры использования:

Больше примеров скриншотов

Пример анализа адреса:

Пример получения сведений о транзакции:

Пример конфигурации рабочего стола Клода

Чтобы использовать этот 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 : Ваш ключ API TON
  • MCP_HOST : Хост сервера (по умолчанию: localhost)
  • MCP_PORT : Порт сервера (по умолчанию: 8000)
  • LOG_LEVEL : Уровень ведения журнала (по умолчанию: INFO)

Документация по инструментам и системным подсказкам MCP

Инструменты

анализировать_адрес

Анализирует адрес TON на предмет баланса, сбережений жетонов, NFT и недавней активности. При желании выполняет глубокий криминалистический анализ, если deep_analysis имеет значение True. Используйте для вопросов об обзоре счета, сбережениях или активности.

Параметры:

  • address (str): адрес TON для анализа
  • deep_analysis (bool, необязательно): включить глубокий криминалистический анализ
получить_подробности_транзакции

Получите детали и анализ для конкретной транзакции блокчейна TON по ее хэшу. Используйте для вопросов о конкретной транзакции, ее участниках, стоимости или типе.

Параметры:

  • tx_hash (str): Хэш транзакции
найти_горячие_тенденции

Найдите популярные токены, пулы или аккаунты в блокчейне TON для заданного периода времени и категории. Используйте для вопросов о том, что сейчас в тренде, популярно или актуально в TON.

Параметры:

  • timeframe (str, необязательно): период времени (например, 1 ч, 24 ч, 7 дн.)
  • category (str, необязательно): Тип трендов (токены, пулы, счета)
анализировать_торговые_шаблоны

Анализируйте торговые модели для адреса TON за указанный период времени. Используйте для вопросов о торговой активности, частоте, переводах жетонов или свопах DEX для учетной записи.

Параметры:

  • address (str): адрес TON
  • timeframe (str, необязательно): Период времени (например, 24 часа)
получить_тонную_цену

Получите текущую цену TON в реальном времени в указанной валюте (по умолчанию: USD) и последние изменения цен. Используйте этот инструмент, когда вам нужна последняя цена 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. Ничто в этом проекте не является финансовым советом. Используйте на свой страх и риск.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, который обеспечивает взаимодействие на естественном языке с блокчейном TON, позволяя пользователям выполнять запросы балансов, анализировать торговые модели, выявлять горячие тенденции и проводить судебные расследования данных блокчейна.

  1. Функции
    1. Быстрый старт
      1. Предпосылки
      2. Установка
      3. Установка PyPI
      4. Использование Докера
    2. Пример: использование TON MCP Server с Claude Desktop
      1. Больше примеров скриншотов
      2. Пример конфигурации рабочего стола Клода
    3. Использование
      1. Базовые запросы
      2. Примеры естественного языка
    4. Конфигурация
      1. Документация по инструментам и системным подсказкам MCP
        1. Инструменты
        2. Системные подсказки
      2. Внося вклад
        1. Лицензия
          1. Поддерживать

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.
              Last updated -
              Python
              • Linux
              • Apple
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
              Last updated -
              JavaScript
              • Linux
              • Apple
            • -
              security
              A
              license
              -
              quality
              A production-ready Model Context Protocol server implementation that connects AI assistants to the TON blockchain, allowing them to query wallet balances, transaction details, smart contracts, and other blockchain data.
              Last updated -
              TypeScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              A server that provides tools for interacting with MantraChain blockchain through the Model Context Protocol, allowing users to manage tokens, stake assets, query balances, and execute various blockchain operations.
              Last updated -
              18
              55
              2
              TypeScript
              MIT License

            View all related MCP servers

            ID: k74ktaursb