DexPaprika MCP Server

DexPaprika MCP 서버

AI 어시스턴트가 실시간 토큰, 풀, DEX 데이터를 프로그래밍 방식으로 가져올 수 있도록 설계된, DexPaprika의 암호화폐 및 DEX 데이터 API에 대한 온디맨드 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 설정이 전혀 필요하지 않습니다.

요약

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

DexPaprika MCP는 Claude를 여러 블록체인의 실시간 DEX 데이터에 연결합니다. API 키가 필요하지 않습니다. 설치 | 설정 | API 레퍼런스

설정 없이 사용하고 싶으신가요? mcp.dexpaprika.com의 호스팅된 MCP 서버를 사용하세요 — 설치 불필요, API 키 불필요, 동일한 14개의 도구. 전송 엔드포인트는 호스팅 대안을 참조하세요.

버전 1.3.0 업데이트 하이라이트

새로운 도구: getCapabilities (워크플로우, 동의어, 모범 사례를 포함한 에이전트 온보딩) 및 getNetworkPoolsFilter (거래량, 트랜잭션, 생성 시간별 서버 측 풀 필터링).

주요 변경: 매개변수 이름이 snake_case로 변경되었습니다 (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_by). 페이지네이션은 이제 1부터 시작합니다. 전체 마이그레이션 가이드는 CHANGELOG.md를 참조하세요.

무엇을 구축할 수 있나요?

• 토큰 분석 도구: 가격 움직임, 유동성 깊이 변화, 거래량 패턴 추적
• DEX 비교: 다양한 DEX의 수수료 구조, 거래량, 사용 가능한 풀 분석
• 유동성 풀 분석: TVL 변화, 비영구적 손실 계산, 가격 영향 평가 모니터링
• 시장 분석: 크로스체인 토큰 비교, 거래량 추세, 거래 활동 지표
• 포트폴리오 추적기: 실시간 가치 추적, 과거 성과 분석, 수익 기회
• 기술적 분석: 추세 식별, 패턴 인식, 지표 계산을 포함한 과거 OHLCV 데이터를 사용한 고급 기술적 분석 수행

설치

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 DexPaprika를 자동으로 설치하려면:

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

수동 설치

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

서버는 기본적으로 8010 포트에서 실행됩니다. 성공적으로 시작되면 MCP server is running at http://localhost:8010이 표시됩니다.

비디오 튜토리얼

DexPaprika MCP 서버 설정 및 사용에 대한 단계별 튜토리얼을 시청하세요:

Claude Desktop 통합

Claude Desktop 설정 파일에 다음을 추가하세요:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp"]
    }
  }
}

Claude Desktop을 다시 시작하면 DexPaprika 도구를 Claude에서 자동으로 사용할 수 있습니다.

호스팅 대안 (설치 불필요)

설정 없이 사용하려면 MCP 호환 클라이언트를 mcp.dexpaprika.com의 호스팅된 서버로 직접 연결하세요. 랜딩 페이지에서 설정 지침과 문서를 제공합니다. 다음 전송 엔드포인트를 사용할 수 있습니다:

전송	엔드포인트	사용 사례
스트리밍 가능 HTTP	https://mcp.dexpaprika.com/streamable-http	대부분의 클라이언트에 권장
SSE	https://mcp.dexpaprika.com/sse	레거시 SSE 전송
JSON-RPC	https://mcp.dexpaprika.com/mcp	직접 JSON-RPC

참고: 이는 MCP 프로토콜 엔드포인트이므로 브라우저에 아무것도 표시되지 않습니다. 랜딩 페이지는 mcp.dexpaprika.com을 방문하세요.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

사용 가능한 도구 (14개)

검색

도구	설명
getCapabilities	서버 기능, 워크플로우 패턴, 네트워크 동의어, 모범 사례. 여기서 시작하세요.
getNetworks	지원되는 33개의 모든 블록체인 네트워크 나열
getStats	상위 수준 생태계 통계 (총 네트워크, DEX, 풀, 토큰)
search	이름, 심볼 또는 주소로 모든 네트워크에서 토큰, 풀, DEX 검색

DEX 작업

도구	설명	필수 매개변수
getNetworkDexes	특정 네트워크의 DEX 나열	network

풀 작업

도구	설명	필수 매개변수
getNetworkPools	기본 — 네트워크의 상위 유동성 풀 가져오기	network
getDexPools	특정 DEX의 풀 가져오기	network, dex
getNetworkPoolsFilter	거래량, 트랜잭션, 생성 시간별 풀 필터링	network
getPoolDetails	상세 풀 정보 (가격, 거래량, TVL, 토큰)	network, pool_address
getPoolOHLCV	과거 OHLCV 캔들 데이터	network, pool_address, start
getPoolTransactions	풀의 최근 트랜잭션/거래	network, pool_address

토큰 작업

도구	설명	필수 매개변수
getTokenDetails	상세 토큰 정보	network, token_address
getTokenPools	토큰을 포함하는 유동성 풀	network, token_address
getTokenMultiPrices	최대 10개 토큰의 일괄 가격	network, tokens[]

사용 예시

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find all pools for a specific token with volume sorting:
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd",
  limit: 5
});

// Get top pools on Ethereum:
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: 1710806400,
  sort_by: "volume_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "2023-01-01",
  interval: "24h",
  limit: 30
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Claude를 위한 샘플 프롬프트

• "솔라나의 JUP 토큰을 분석해줘. 가격, 거래량, 상위 유동성 풀을 가져와."
• "이더리움에서 Uniswap V3와 SushiSwap의 거래량을 비교해줘."
• "Raydium에서 SOL/USDC의 7일 OHLCV 데이터를 가져와서 가격 차트를 그려줘."
• "Fantom 네트워크에서 유동성 기준 상위 5개 풀을 찾아 수수료 구조를 분석해줘."
• "Uniswap에서 ETH/USDT 풀의 최근 트랜잭션을 가져와 매수 대 매도 압력을 분석해줘."
• "이더리움에서 24시간 거래량 기준 상위 10개 풀을 보여줘."
• "ARB 토큰을 포함하는 모든 풀을 검색하고 거래량 순으로 정렬해줘."
• "지난주에 생성된 24시간 거래량 $100K 이상의 이더리움 풀을 필터링해줘."
• "먼저 사용 가능한 모든 네트워크를 가져온 다음, 각 주요 네트워크의 상위 풀을 보여줘."

속도 제한 및 성능

• 무료 티어 제한: 하루 10,000 요청
• 응답 시간: 대부분의 엔드포인트에서 100-500ms (네트워크에 따라 다름)
• 데이터 신선도: 풀 및 토큰 데이터는 15-30초마다 업데이트됨
• 오류 처리: 코드, 제안, 재시도 지침이 포함된 구조화된 오류
• OHLCV 데이터 가용성: 과거 데이터는 일반적으로 토큰/풀 생성일부터 사용 가능

문제 해결

일반적인 문제:

• 속도 제한: DP429_RATE_LIMIT 오류가 발생하면 지수 백오프를 구현하세요
• 데이터 누락: 일부 새로운 토큰/풀은 과거 데이터가 불완전할 수 있습니다
• 시간 초과 오류: 대량 데이터 요청은 시간이 더 걸릴 수 있으므로 페이지네이션을 고려하세요
• 네트워크 오류: 네트워크 연결을 확인하세요. 서비스는 인터넷 액세스가 필요합니다
• OHLCV 제한: 시작일과 종료일 사이의 최대 범위는 1년입니다. 더 긴 기간에는 페이지네이션을 사용하세요
• 빈 OHLCV: 풀이 너무 새 것일 수 있습니다 — 대신 getPoolTransactions을 사용하세요

개발

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

변경 로그

자세한 릴리스 노트와 마이그레이션 가이드는 CHANGELOG.md를 참조하세요.

라이선스

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

추가 리소스

• DexPaprika API 문서
• 호스팅된 MCP 서버 — 설정 없는 대안
• 모델 컨텍스트 프로토콜 사양
• DexPaprika - 포괄적인 온체인 분석 시장 데이터
• CoinPaprika - 포괄적인 암호화폐 시장 데이터