Dune 쿼리 MCP

파이썬

모델 제어 프로토콜(MCP)을 통해 Dune Analytics 데이터를 지능형 에이전트에 연결하는 현대적인 브리지입니다.

개요

dune-query-mcp는 블록체인 데이터 분석을 AI 애플리케이션에 원활하게 통합할 수 있도록 지원합니다. Dune Analytics의 강력한 쿼리 기능과 모델 제어 프로토콜(MCP)을 활용하여 LLM 및 기타 AI 시스템이 간단하고 자연스러운 언어 상호작용을 통해 온체인 데이터에 액세스할 수 있도록 지원합니다.

Related MCP server: Bankless Onchain MCP Server

핵심 역량

데이터 검색 도구

도구	설명	사용 사례
`get_latest_result`	미리 계산된 쿼리 결과를 검색합니다.	기존 데이터에 빠르게 액세스
`run_query`	필요에 따라 쿼리를 실행합니다.	실시간 데이터 분석

데이터 형식

모든 데이터는 CSV 형식으로 반환되며 다음이 제공됩니다.

범용 호환성
대부분의 데이터 분석 도구로 쉽게 구문 분석 가능
사람이 읽을 수 있는 출력

시작하기

시스템 요구 사항

Python 3.10 이상
유효한 Dune Analytics API 키( 여기서 받으세요 )

빠른 설정

복제 및 탐색
지엑스피1
환경 설정
# Create virtual environment python -m venv .venv # Activate it source .venv/bin/activate # Linux/Mac # or .venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt
API 액세스 구성
# Copy example config cp .env.example .env # Edit with your API key echo "DUNE_API_KEY=your_key_here" > .env

용법

서비스 실행

dune-query-mcp는 두 가지 실행 방법을 제공합니다.

MCP 서비스로서

python run.py

이렇게 하면 기본 포트 8000에서 MCP 서비스가 시작됩니다.

웹 서버로서

python flask_app.py

이를 통해 웹 인터페이스와 REST API 엔드포인트에 액세스할 수 있습니다.

애플리케이션과 통합

MCP 클라이언트 통합

from mcp.client import Client # Connect to Dune-query-mcp client = Client("http://localhost:8000") # Get latest results for a query csv_data = client.call("get_latest_result", query_id=1234567) # Execute a query query_results = client.call("run_query", query_id=1234567)

REST API

엔드포인트	방법	설명
`/dune/health`	얻다	서비스 상태 점검
`/dune/query/{query_id}/latest`	얻다	최신 결과 검색
`/dune/query/{query_id}/execute`	우편	쿼리 실행

REST 호출 예시:

curl -X GET http://localhost:5000/dune/query/1234567/latest

건축학

dune-query-mcp/ ├── app/ # Application core │ ├── __init__.py # Flask & MCP setup │ ├── routes/ # API endpoint definitions │ │ └── dune_routes/ # Dune Analytics routes │ │ └── templates/ # Web interface │ └── templates/ # Web interface ├── config/ # Configuration files ├── logs/ # Runtime logs ├── flask_app.py # Web server entry point ├── run.py # MCP server entry point └── requirements.txt # Dependencies

고급 구성

환경 변수

변하기 쉬운	목적	기본
DUNE_API_KEY	Dune API 인증	없음 (필수)
포트	서버 포트	8000

성능 튜닝

대량 쿼리 실행의 경우:

# Set a higher timeout for long-running queries export DUNE_QUERY_TIMEOUT=600 # 10 minutes in seconds

문제 해결

일반적인 문제 및 해결 방법:

문제	해결책
API 키 오류	유효한 키가 있는 `.env` 파일이 있는지 확인하세요.
시간 초과 오류	복잡한 쿼리에 대한 시간 초과 증가
CSV 구문 분석 문제	쿼리 확인 시 적절한 표 형식 데이터가 반환됩니다.

기여하다

여러분의 참여를 환영합니다! 다음 단계를 따라주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다: git checkout -b feature/amazing-feature
변경 사항을 커밋하세요: git commit -am 'Add some amazing feature'
브랜치에 푸시: git push origin feature/amazing-feature
풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

FastMCP 로 구축됨
Dune Analytics 가 제공하는 쿼리 기능

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Dune Query MCP