Rug-Check-MCP

Rug-Check-MCP

Solana のミームトークンに潜むリスクを検出し、AI エージェントがラグプルや安全でないプロジェクトを回避できるようにする MCP サーバーです。

機能

• トークン分析ツール：analysis_token ツールは、Solsniffer API から Solana トークンデータを取得して処理します。
• 構造化出力：名前、シンボル、Snif スコア、時価総額、価格、供給量、リスク、監査状況など、詳細なトークン情報を返します。

前提条件

• Python 3.10 以降
• Solsniffer API キー（Solsniffer に登録して取得してください）

インストール

Smithery 経由でのインストール

Smithery を使って、Rug Check を Claude Desktop に自動でインストールするには：

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

手動インストール

1. リポジトリをクローンする：

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

2. 依存関係をインストールする： pip がインストールされていることを確認してから、次のコマンドを実行します：

   pip install mcp[cli] requests python-dotenv
   

3. クライアントの設定：

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

ツール：analysis_token

• 説明：アドレスを基に Solana トークンを分析します。
• 入力：token_address（文字列）- 分析する Solana トークンのアドレス。
• 出力：以下を含む辞書：
  • token_address：トークンのアドレス
  • token_name：トークン名
  • token_symbol：トークンのシンボル
  • snif_score：Solsniffer のリスクスコア（0～100）
  • market_cap：米ドルでの時価総額
  • price：米ドルでのトークン価格
  • supply_amount：トークンの総供給量
  • risks：高・中・低リスクの詳細、件数、説明
  • audit_risk：監査状況（ミント／凍結の無効化、LP のバーン、上位 10 保有者）

出力例

トークンアドレス 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
  }
}

プロンプトの例

以下は、MCP 対応クライアント（例：Claude Desktop）で使用できるプロンプトと、analysis_token ツールの呼び出し後に期待される応答の例です。

プロンプト：

「アドレス 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p の Solana トークンを分析してもらえますか？」

応答：

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.     

プロンプト：

「トークン So11111111111111111111111111111111111111112 のリスクプロファイルはどのようなものですか？」

応答：

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.     

プロンプト：

「トークン 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R について教えてください。」

応答：

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.     

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE をご覧ください。