MCP 문서 관리

메뉴

문서 정보

최종 수정일:
2025-05-13 10:52

Heurist

Heurist

Heurist Mesh MCP 서버는 블록체인 분석, 스마트 계약 보안, 토큰 메트릭스 등을 위한 전문 Web3 AI 에이전트에 접근할 수 있게 해주는 서비스입니다. Heurist Mesh는 블록체인 데이터 분석, 스마트 계약 보안, 토큰 메트릭스, 블록체인 상호작용 등 특정 Web3 도메인에 특화된 목적별 AI 에이전트와 도구로 구성된 오픈 네트워크입니다.

특징

  • 통합 에이전트 네트워크: 100개 이상의 Web3 도구에 접근할 수 있는 다양한 전문 에이전트 제공
  • 단일 API 키 접근: 하나의 API 키로 CoinGecko, GoPlus 등 여러 서비스에 접근 가능
  • 호스팅된 SSE 엔드포인트: 공유 서버를 통해 일반적인 에이전트에 쉽게 접근 가능
  • 맞춤형 서버 구성: 특정 사용 사례에 맞게 에이전트를 추가하거나 제거하여 서버를 사용자 지정 가능
  • 다중 블록체인 지원: 이더리움, 솔라나 등 다양한 블록체인 네트워크 분석 및 상호작용 지원

API

리소스

  • 블록체인 데이터: 다양한 블록체인 네트워크의 온체인 데이터 제공
  • 토큰 정보: 암호화폐 토큰에 관한 시장 데이터 및 보안 정보 제공
  • 소셜 미디어 데이터: Twitter 등의 소셜 미디어에서 암호화폐 관련 인텔리전스 제공

도구

토큰 분석 도구

  • get_token_info: 특정 토큰의 정보를 조회합니다.
  • 입력:
    • contract_address (문자열): 토큰 계약 주소
    • chain_id (정수 또는 문자열): 블록체인 체인 ID 또는 'solana'(솔라나 토큰용)
  • 출력: 토큰 기본 정보, 시장 데이터, 보유자 분석 등

  • get_trending_tokens: 인기 있는 토큰 목록을 조회합니다.

  • 입력: 제한 수(선택), 카테고리(선택)
  • 출력: 인기 토큰 목록 및 관련 데이터

보안 분석 도구

  • analyze_contract_security: 스마트 계약의 보안을 분석합니다.
  • 입력: 계약 주소, 체인 ID
  • 출력: 보안 취약점, 위험 요소, 안전 점수 등

  • check_token_security: 토큰 계약의 보안 상태를 확인합니다.

  • 입력: 토큰 계약 주소, 체인 ID
  • 출력: 토큰 보안 평가, 잠재적 사기 지표, 토큰 안전 점수

월렛 분석 도구

  • analyze_wallet: 지갑 주소를 분석합니다.
  • 입력: 지갑 주소, 체인 ID
  • 출력: 자산 분석, 거래 패턴, 상호작용한 계약 등

  • analyze_wallet_clusters: 토큰 보유자의 지갑 클러스터를 분석합니다.

  • 입력: 토큰 계약 주소, 체인 ID
  • 출력: 보유자 행동, 집중도, 잠재적 시장 조작 분석

시장 데이터 도구

  • get_dex_trading_data: 분산형 거래소(DEX)의 거래 데이터를 조회합니다.
  • 입력: 토큰 쌍, DEX 이름(선택), 체인 ID(선택)
  • 출력: 실시간 거래량, 가격, 유동성 데이터

  • get_market_data: 암호화폐 시장 데이터를 조회합니다.

  • 입력: 암호화폐 심볼, 기간(선택)
  • 출력: 가격, 거래량, 시가총액 등 시장 정보

소셜 인텔리전스 도구

  • analyze_twitter_intelligence: Twitter 데이터를 사용하여 토큰, 주제 또는 계정을 분석합니다.
  • 입력: 토큰 심볼, 계정 이름 또는 주제, 기간(선택)
  • 출력: 인플루언서 분석, 감성 분석, 트렌드 데이터

검색 도구

  • web_search: 웹을 검색하고 질문에 직접 답변합니다.
  • 입력: 검색 쿼리
  • 출력: 검색 결과 및 답변

지원 에이전트

Heurist Mesh MCP 서버는 다음과 같은 전문 에이전트를 포함합니다:

  1. BitquerySolanaTokenInfoAgent: 솔라나 토큰의 메트릭스, 보유자, 거래 활동 등에 대한 포괄적인 분석을 제공합니다.

  2. CoinGeckoTokenInfoAgent: CoinGecko에서 토큰 정보, 시장 데이터, 인기 코인, 카테고리 데이터를 가져옵니다.

  3. DexScreenerTokenInfoAgent: 여러 체인에서 실시간 DEX 거래 데이터 및 토큰 정보를 가져옵니다.

  4. ElfaTwitterIntelligenceAgent: Twitter 데이터를 사용하여 토큰, 주제 또는 계정을 분석하고 영향력 있는 인플루언서를 강조합니다.

  5. ExaSearchAgent: 웹을 검색하고 질문에 직접 답변을 제공합니다.

  6. GoplusAnalysisAgent: 블록체인 토큰 계약의 보안 세부 정보를 가져와 분석합니다.

  7. MetaSleuthSolTokenWalletClusterAgent: 솔라나 토큰을 보유한 지갑 클러스터를 분석하여 보유자 행동, 집중도 및 잠재적 시장 조작을 식별합니다.

사용 방법

Heurist Mesh MCP 서버를 사용하려면:

  1. Heurist API 키 얻기:
  2. https://heurist.ai/dev-access에서 API 키를 얻습니다.

  3. 저장소 복제 및 설정:

    # 저장소 복제
    git clone https://github.com/heurist-network/heurist-mesh-mcp-server
    cd heurist-mesh-mcp-server
    
    # 도커 이미지 빌드
    docker build -t mesh-tool-server .

  4. Claude Desktop 설정 구성:

    {
      "mcpServers": {
        "heurist-mesh-agent": {
          "command": "uv",
          "args": [
            "--directory",
            "/path/to/heurist-mesh-mcp-server/mesh_mcp_server",
            "run",
            "mesh-tool-server"
          ],
          "env": {
            "HEURIST_API_KEY": "your-api-key-here"
          }
        }
      }
    }

  5. 또는 도커를 사용한 설정:

    {
      "mcpServers": {
        "mesh-agent": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "-e",
            "TRANSPORT=stdio",
            "-e",
            "HEURIST_API_KEY=your-api-key-here",
            "mesh-tool-server"
          ]
        }
      }
    }

  6. 호스팅된 SSE 엔드포인트 사용: Heurist는 https://sequencer-v2.heurist.xyz/mcp/sse 에서 호스팅된 SSE 엔드포인트를 제공합니다. 이 엔드포인트는 공유 서버이므로 성능이 불안정할 수 있습니다.

  7. Heurist MCP 포털 사용: https://mcp.heurist.ai 에서 사용 사례에 맞게 맞춤형 MCP 서버를 구성할 수 있습니다.

사용자 정의

특정 요구 사항에 맞게 서버에서 사용 가능한 에이전트를 수정하려면:

  1. server.py 파일을 열고 Config 클래스를 찾습니다.
  2. DEFAULT_AGENTS 목록을 편집하여 에이전트를 추가하거나 제거합니다.
  3. Heurist Metadata에 나열된 에이전트를 참조하여 원하는 에이전트를 선택합니다.

사용 사례

Heurist Mesh MCP 서버는 다음과 같은 시나리오에서 특히 유용합니다:

  1. 암호화폐 투자 분석: 시장 데이터, 토큰 보안, 투자자 행동 등을 분석하여 투자 결정을 돕습니다.

  2. 스마트 계약 보안 감사: 스마트 계약의 보안 취약점을 식별하고 잠재적 위험을 평가합니다.

  3. 토큰 보안 평가: 새로운 토큰 프로젝트의 보안 상태를 평가하여 사기 및 위험을 식별합니다.

  4. 월렛 포렌식: 온체인 활동 및 거래 패턴을 분석하여 지갑 또는 토큰 보유자의 행동을 파악합니다.

  5. 시장 인텔리전스: 소셜 미디어 분석, 트렌드 데이터, 시장 메트릭스를 통해 시장 인텔리전스를 수집합니다.

연결된 구성 요소