TON BLOCKCHAIN MCP

TON BLOCKCHAIN MCP

Um servidor Model Context Protocol (MCP) para interação em linguagem natural com a blockchain TON.

Recursos

• Processamento de Linguagem Natural: Entenda consultas complexas de blockchain em inglês simples
• Análise de Negociação: Analise padrões de negociação, lucratividade e estratégias
• Detecção de Tendências Quentes: Encontre tokens em alta, pools ativos e contas de alta atividade
• Perícia e Conformidade: Conduza investigações de blockchain e verificações de conformidade
• Dados em Tempo Real: Acesse dados ao vivo da blockchain TON através da API TON

Início Rápido

Pré-requisitos

• Python 3.10+
• Chave da API TON do TONAPI

Configuração de Ambiente (.env)

Para fornecer com segurança configurações sensíveis (como sua chave da API TON), crie um arquivo .env no diretório raiz do projeto. Este arquivo será carregado automaticamente se estiver presente.

Exemplo de arquivo .env:

TON_API_KEY=YOUR_TON_API_KEY

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

pip install -r requirements.txt

---

Usando o Servidor TON MCP com Claude Desktop

Você pode facilmente usar este servidor MCP com o Claude Desktop para consultas de blockchain em linguagem natural. Abaixo estão alguns exemplos de casos de uso:

Exemplo de Detecção de Golpes:

Exemplo de Análise de Endereço:

Exemplo de Obtenção de Detalhes de Transação:

Exemplo de Análise de Padrões de Negociação:

Exemplo de Configuração do Claude Desktop

Para usar este servidor MCP com o Claude Desktop, adicione o seguinte à sua configuração do Claude Desktop:

• Talvez seja necessário substituir a configuração do ambiente Python pela sua própria.

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

---

Exemplos de Linguagem Natural

• "Qual é o saldo do endereço EQD1234...?"
• "Encontre pares de negociação quentes na última hora"
• "Analise padrões de negociação para esta carteira"
• "Mostre atividade suspeita para o endereço ABC"
• "Rastreie o fluxo de dinheiro deste endereço"

Documentação de Ferramentas MCP e Prompts de Sistema

Ferramentas

analyze_address

Analise um endereço TON para seu saldo, participações em jetton, NFTs e atividade recente. Opcionalmente, realiza análise forense profunda se deep_analysis for True. Use para perguntas sobre visão geral da conta, participações ou atividade.

Parâmetros:

• address (str): Endereço TON para analisar
• deep_analysis (bool, opcional): Ativar análise forense profunda

get_transaction_details

Obtenha detalhes e análise de uma transação específica da blockchain TON pelo seu hash. Use para perguntas sobre uma transação específica, seus participantes, valor ou tipo.

Parâmetros:

• tx_hash (str): Hash da transação

find_hot_trends

Encontre tokens, pools ou contas em alta na blockchain TON para um período e categoria determinados. Use para perguntas sobre o que está quente, em tendência ou popular na TON.

Parâmetros:

• timeframe (str, opcional): Período de tempo (ex.: 1h, 24h, 7d)
• category (str, opcional): Tipo de tendências (tokens, pools, contas)

analyze_trading_patterns

Analise padrões de negociação para um endereço TON em um período especificado. Use para perguntas sobre atividade de negociação, frequência, transferências de jetton ou swaps DEX para uma conta.

Parâmetros:

• address (str): Endereço TON
• timeframe (str, opcional): Período de tempo (ex.: 24h)

get_ton_price

Obtenha o preço atual em tempo real da TON na moeda especificada (padrão: USD) e as mudanças recentes de preço. Use esta ferramenta sempre que precisar do preço mais recente da TON para cálculos, análise ou relatórios.

Parâmetros:

• currency (str, opcional): A moeda fiduciária ou cripto para obter o preço da TON (padrão: 'usd').

get_jetton_price

Obtenha o preço atual e as mudanças recentes para tokens jetton especificados (não TON) na moeda fornecida. Forneça uma lista de endereços mestres de jetton como tokens. Use esta ferramenta para buscar preços em tempo real de qualquer token, exceto TON.

Parâmetros:

• tokens (lista de str): Lista de endereços mestres de jetton para obter preços (excluindo 'ton').
• currency (str, opcional): A moeda fiduciária ou cripto para obter o preço (padrão: 'usd').

Prompts de Sistema

• trading_analysis: Gerar prompts de análise de negociação
• forensics_investigation: Gerar prompts de perícia
• trend_analysis: Gerar prompts de análise de tendências

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso
3. Faça commit das suas alterações
4. Envie para o branch
5. Crie um Pull Request

Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Suporte

Para suporte, por favor abra uma issue no GitHub

⚠️ AVISO: Este projeto está em Beta. Não confie em nenhum número fornecido pelo modelo LLM. Nada neste projeto constitui aconselhamento financeiro. Use por sua conta e risco.