Dune Analytics MCP 서버

“Dune Analytics” MCP 서버는 무엇을 하나요?

Dune Analytics MCP 서버는 Dune Analytics와 AI 에이전트 간의 다리 역할을 하는 Model Context Protocol(MCP) 서버입니다. 이 서버의 주요 목적은 Dune 쿼리를 프로그래밍 방식으로 가져오고 실행할 수 있게 하여, 블록체인 분석 데이터를 AI 기반 워크플로우에 원활하게 통합하도록 지원하는 것입니다. Dune Analytics 데이터를 도구로 노출함으로써, 개발자와 AI 클라이언트는 실시간 블록체인 데이터 조회, 분석, 리포팅을 자신의 자동화 또는 에이전트 워크플로우 내에서 수행할 수 있습니다. 서버의 CSV 출력 포맷은 후속 데이터 처리와의 호환성을 보장하여 온체인 분석, 대시보드 생성, 개발 환경에서의 자동화 리포팅 등에 유용하게 활용됩니다.

프롬프트 목록

저장소나 문서에 명시적인 프롬프트 템플릿이 나와 있지 않습니다.

리소스 목록

문서나 코드에 명시적인 리소스가 설명되거나 노출되어 있지 않습니다.

도구 목록

• get_latest_result
  • 쿼리 ID로 Dune Analytics의 최신 결과를 가져옵니다. 출력은 쿼리 결과가 담긴 CSV 문자열입니다.
• run_query
  • 지정된 Dune Analytics 쿼리를 ID로 실행하고 결과를 조회합니다. 역시 CSV 문자열로 데이터를 반환합니다.

이 MCP 서버의 활용 사례

• 블록체인 데이터 분석
  • AI 에이전트에서 Dune Analytics 쿼리를 직접 실행하여 블록체인 데이터의 조회 및 분석을 자동화합니다.
• 대시보드 생성
  • MCP 인터페이스를 통해 Dune Analytics 데이터를 가져와 동적 대시보드나 리포팅 도구를 구동합니다.
• 자동 크립토 마켓 리포팅
  • 봇이나 어시스턴트가 블록체인 활동, DeFi 프로토콜, 토큰 분석에 대한 최신 리포트를 자동으로 생성할 수 있습니다.
• 데이터 기반 스마트 컨트랙트 모니터링
  • Dune 쿼리로 특정 트리거를 조회하여 스마트 컨트랙트나 온체인 이벤트를 실시간 모니터링하고 결과를 표출할 수 있습니다.
• 연구 및 데이터 사이언스 워크플로우
  • 데이터 사이언스 파이프라인에 자동 Dune 쿼리를 삽입하여 크립토 리서치 실험과 데이터 수집을 빠르게 진행할 수 있습니다.

설치 방법

Windsurf

1. Python 3.10+과 유효한 Dune Analytics API 키를 준비하세요.
2. Windsurf 설정 파일에서 mcpServers 섹션을 찾으세요.
3. 아래 JSON 스니펫을 추가하여 Dune Analytics MCP 서버를 등록하세요:

   {
     "mcpServers": {
       "dune-analytics": {
         "command": "python",
         "args": ["main.py"]
       }
     }
   }
   

4. 설정을 저장하고 Windsurf를 재시작하세요.
5. 인터페이스에서 테스트 Dune 쿼리를 발행하여 정상동작을 확인하세요.

API 키 보안 설정:
환경 변수에 DUNE_API_KEY를 등록하세요. 예시:

{
  "mcpServers": {
    "dune-analytics": {
      "command": "python",
      "args": ["main.py"],
      "env": {
        "DUNE_API_KEY": "${DUNE_API_KEY}"
      },
      "inputs": {
        "DUNE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude

1. Smithery CLI로 서버 설치:

   npx -y @smithery/cli install @kukapay/dune-analytics-mcp --client claude
   

2. DUNE_API_KEY를 환경 변수로 등록하세요.
3. Claude Desktop에서 MCP 서버가 등록되어 실행 중인지 확인하세요.
4. 명령어 인터페이스에서 Dune 쿼리를 직접 실행하세요.
5. 출력이 CSV 포맷으로 정상 반환되는지 확인하세요.

Cursor

1. Python 3.10+을 설치하고 Dune API 키를 발급받으세요.
2. Cursor 설정 파일에 다음 내용을 추가하세요:

   {
     "mcpServers": {
       "dune-analytics": {
         "command": "python",
         "args": ["main.py"]
       }
     }
   }
   

3. 환경 또는 설정에 API 키를 등록하세요.
4. Cursor를 재시작하고 연결을 테스트하세요.

Cline

1. Python 3.10+이 설치되어 있고 API 키가 준비되어 있는지 확인하세요.
2. Cline 설정에 MCP 서버 정의를 추가하세요:

   {
     "mcpServers": {
       "dune-analytics": {
         "command": "python",
         "args": ["main.py"]
       }
     }
   }
   

3. 쉘이나 환경 변수로 DUNE_API_KEY를 export 하세요.
4. Cline을 재시작하고 샘플 쿼리로 정상 동작을 확인하세요.

API 키 보안 (모든 플랫폼에 적용):
항상 환경 변수를 사용하여 API 키가 설정 파일에 평문으로 노출되지 않도록 하세요.

FlowHunt 플로우에서 MCP 사용하기

FlowHunt에서 MCP 통합하기

FlowHunt 워크플로우에 MCP 서버를 추가하려면, 플로우에 MCP 컴포넌트를 추가하고 AI 에이전트에 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 설정 섹션에서 아래 JSON 포맷으로 MCP 서버 정보를 입력하세요:

{
  "dune-analytics": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면, AI 에이전트가 해당 MCP의 모든 기능과 도구를 사용할 수 있습니다. “dune-analytics"를 실제 MCP 서버 이름으로, URL을 본인의 MCP 서버 주소로 교체하세요.

개요

의견

Dune Analytics MCP 서버는 Dune Analytics 쿼리 접근을 도구로 제공하는 데 초점을 맞춘 단순하고 명확한 MCP입니다. 블록체인 분석 워크플로우에 실용적이지만, 프롬프트 템플릿이나 명시적 리소스, roots나 샘플링 등 고급 MCP 기능은 제공하지 않습니다. 설치 및 사용 문서가 잘 되어 있습니다. 0~10점 척도에서 6/10을 부여하며, 명확한 실용성과 우수한 문서화에 비해 MCP 기능 범위가 제한적인 점이 아쉽습니다.

MCP 점수