Rug-Check-MCP

Rug-Check-MCP

Um servidor MCP que detecta riscos potenciais em tokens meme da Solana, ajudando agentes de IA a evitar rug pulls e projetos inseguros.

Recursos

• Ferramenta de Análise de Tokens: A ferramenta analysis_token recupera e processa dados de tokens Solana da API do Solsniffer.
• Saída Estruturada: Retorna informações detalhadas do token, incluindo nome, símbolo, pontuação Snif, capitalização de mercado, preço, oferta, riscos e status de auditoria.

Pré-requisitos

• Python 3.10 ou superior
• Uma chave de API do Solsniffer (cadastre-se em Solsniffer para obter uma)

Instalação

Instalação via Smithery

Para instalar o Rug Check para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @kukapay/rug-check-mcp --client claude

Instalação Manual

1. Clone o Repositório:

   git clone https://github.com/kukapay/rug-check-mcp.git
   cd rug-check-mcp
   

2. Instale as Dependências: Certifique-se de ter o pip instalado e execute:

   pip install mcp[cli] requests python-dotenv
   

3. Configuração do Cliente:

   "mcpServers": { 
     "rug-check-mcp": { 
       "command": "python", 
       "args": ["path/to/rug-check-mcp/main.py"], 
       "env": { 
         "SOLSNIFFER_API_KEY": "your_solsniffer_api_key_here" 
       } 
     } 
   }
   

Ferramenta: analysis_token

• Descrição: Analisa um token Solana com base em seu endereço.
• Entrada: token_address (string) - O endereço do token Solana a ser analisado.
• Saída: Um dicionário contendo:
  • token_address: Endereço do token
  • token_name: Nome do token
  • token_symbol: Símbolo do token
  • snif_score: Pontuação de risco do Solsniffer (0-100)
  • market_cap: Capitalização de mercado em USD
  • price: Preço do token em USD
  • supply_amount: Oferta total do token
  • risks: Detalhes de risco alto, moderado e baixo com contagens e descrições
  • audit_risk: Status de auditoria (mint/freeze desabilitados, LP queimado, top 10 detentores)

Exemplo de Saída

Para o endereço de token 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p:

{
  'token_address': '9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p',
  'token_name': 'REVSHARE',
  'token_symbol': 'REVS',
  'snif_score': 55,
  'market_cap': 271893.9423965262,
  'price': 0.000280011574,
  'supply_amount': 971009656.8955618,
  'risks': {
    'high': {
      'count': 3,
      'details': {
        'Mintable risks found': True,
        'Freeze risks found': True,
        'A private wallet owns a significant share of the supply': False,
        'Tokens auto-freeze risks found': True,
        'Significant ownership by top 10 wallets': False,
        'Significant ownership by top 20 wallets': False,
        'Permanent control risks found': True,
        'Presence of token metadata': True,
        'High locked supply risks found': None,
        'Sufficient liquidity detected': None,
        'Very low liquidity': None
      }
    },
    'moderate': {
      'count': 3,
      'details': {
        'Token metadata are immutable': False,
        'Token operates without custom fees': False,
        'Token has recent user activity': True,
        'Unknown liquidity pools': False,
        'Low count of LP providers': True
      }
    },
    'low': {
      'count': 1,
      'details': {
        'Contract was not recently deployed': False
      }
    }
  },
  'audit_risk': {
    'mint_disabled': True,
    'freeze_disabled': True,
    'lp_burned': False,
    'top_10_holders_significant': False
  }
}

Exemplos de Prompts

Abaixo estão exemplos de prompts que você pode usar em um cliente compatível com MCP (ex.: Claude Desktop) e as respostas esperadas após a ferramenta analysis_token ser invocada.

Prompt:

"Você pode analisar o token Solana no endereço 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p?"

Resposta:

I've analyzed the token at address 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p. Here's the summary:

- Token Name: REVSHARE (Symbol: REVS)
- Snif Score: 55/100 (Moderate risk)
- Market Cap: $288,875.29
- Price: $0.000297
- Total Supply: 971,266,696.90 tokens
- Risks:
  - High (3 risks):
    - Mintable risks found: True
    - Freeze risks found: True
    - Permanent control risks found: True
    - (Other factors: False)
  - Moderate (1 risk):
    - Low count of LP providers: True
    - (Other factors: False)
  - Low (0 risks):
    - (All factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: No
  - Top 10 Holders Significant: No

This token has moderate risks due to potential control issues and liquidity concerns, but minting and freezing are disabled for added safety.     

Prompt:

"Qual é o perfil de risco do token So11111111111111111111111111111111111111112?"

Resposta:

Here's the risk profile for the token at address So11111111111111111111111111111111111111112:

- Token Name: Wrapped SOL (Symbol: SOL)
- Snif Score: 92/100 (Low risk)
- Market Cap: $82,345,678.90
- Price: $176.54
- Total Supply: 466,567,890.12 tokens
- Risks:
  - High (0 risks):
    - (All factors: False)
  - Moderate (0 risks):
    - (All factors: False)
  - Low (1 risk):
    - Minor liquidity concentration: True
    - (Other factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: Yes
  - Top 10 Holders Significant: No

Wrapped SOL is a low-risk token with strong audit protections and only a minor liquidity concern, typical for a well-established asset.     

Prompt:

"Fale sobre o token 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R."

Resposta:

Here's the analysis for the token at address 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R:

- Token Name: Raydium (Symbol: RAY)
- Snif Score: 85/100 (Low risk)
- Market Cap: $1,234,567.89
- Price: $4.72
- Total Supply: 261,567,890.12 tokens
- Risks:
  - High (0 risks):
    - (All factors: False)
  - Moderate (1 risk):
    - Moderate holder concentration: True
    - (Other factors: False)
  - Low (0 risks):
    - (All factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: Yes
  - Top 10 Holders Significant: No

Raydium is a low-risk token with solid audit protections. The moderate holder concentration indicates some centralization, but it’s not a major issue.     

Licença

Este projeto está licenciado sob a Licença MIT. Consulte LICENSE para obter detalhes.