dune-analytics-mcp

Dune Analytics MCP 서버

Dune Analytics 데이터를 AI 에이전트에 연결하는 MCP 서버입니다.

특징

• 도구 :
  • get_latest_result : ID로 Dune 쿼리의 최신 결과를 가져옵니다.
  • run_query : ID로 Dune 쿼리를 실행하고 결과를 검색합니다.
• CSV 출력 : 모든 결과는 쉽게 처리할 수 있도록 CSV 형식의 문자열로 반환됩니다.

필수 조건

• 파이썬 3.10+
• 유효한 Dune Analytics API 키( Dune Analytics 에서 하나 받음)

설치

1. 저장소 복제 :지엑스피1
2. 환경 변수 설정 : 프로젝트 루트에 .env 파일을 만듭니다.
   DUNE_API_KEY=your_api_key_here
   또는 시스템 환경 변수로 설정합니다.
   export DUNE_API_KEY="your_api_key_here"

용법

서버 실행

• 개발 모드 :
  mcp dev main.py
  이렇게 하면 개발을 위해 핫 리로딩이 시작됩니다.
• Claude Desktop에 설치 :
  mcp install main.py --name "Dune Analytics"
  Claude Desktop과 함께 사용할 서비스로 서버를 설치합니다.

도구 사용

1. get_latest_result(query_id)
   • 설명 : 지정된 Dune 쿼리의 최신 결과를 검색합니다.
   • 입력 : query_id (int) - Dune 쿼리의 ID입니다.
   • 출력 : 쿼리 결과의 CSV 형식 문자열입니다.
   • 예 :
     get_latest_result(query_id=4853921)
2. run_query(query_id)
   • 설명 : Dune 쿼리를 실행하고 결과를 반환합니다.
   • 입력 : query_id (정수) - 실행할 Dune 쿼리의 ID입니다.
   • 출력 : 쿼리 결과의 CSV 형식 문자열입니다.
   • 예 :
     run_query(query_id=1215383)

Claude Desktop의 예제 명령

• "dune 쿼리 1215383에 대한 최신 결과를 얻으세요"
• "dune 쿼리 1215383 실행"

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.