DexPaprika

DexPaprika MCP Server

DexPaprika의 암호화폐 및 DEX 데이터 API에 온디맨드 액세스를 제공하는 Model Context Protocol(MCP) 서버입니다. Claude와 같은 AI 어시스턴트가 별도의 설정 없이 프로그래밍 방식으로 최신 토큰, 풀 및 DEX 데이터를 가져올 수 있도록 특별히 설계되었습니다.

요약

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP는 Claude를 여러 블록체인의 실시간 DEX 데이터에 연결합니다. 무료 티어는 시작하는 데 API 키가 필요 없습니다. 설치 | 구성 | API 참조

설정이 전혀 필요 없나요? mcp.dexpaprika.com의 호스팅 MCP 서버를 사용하세요: 설치도, 시작용 키도 필요 없으며, 동일한 데이터 도구에 submitFeedback이 추가로 제공됩니다. 전송 엔드포인트는 호스팅 서버를 참조하세요.

최신 릴리스

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

무엇을 만들 수 있나요?

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

설치

Smithery로 설치

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

npx -y smithery mcp add coinpaprika/dexpaprika

수동 설치

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

# Start the server
dexpaprika-mcp

이것은 stdio 서버입니다: stdin과 stdout을 통해 MCP를 사용하며 포트를 바인딩하지 않습니다. 시작 시 DexPaprika MCP server v<version> (tool contract v<contract>) is running...을 stderr에 기록한 후 클라이언트를 기다립니다. 브라우저에서 URL을 기대하지 말고 MCP 클라이언트(Claude Desktop, Cursor, Claude Code)에서 실행하세요.

비디오 튜토리얼

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@latest"]
    }
  }
}

Claude Desktop을 다시 시작하면 DexPaprika 도구가 Claude에서 자동으로 사용 가능해집니다.

선택 사항: API 키 사용

키 없이도 작동하며 앞으로도 항상 그럴 것입니다. 가입도, 카드도, 구성할 것도 없습니다. 위의 모든 내용이 지원되는 실행 방법입니다.

무료 키는 월별 할당량을 높이고 공개 쇼케이스 세트가 아닌 모든 토큰에서 스트리밍을 활성화합니다. 분당 요청 제한은 높이지 않으며, 두 티어 모두 동일합니다. console.dexpaprika.com에서 키를 받을 수 있으며, 현재 한도는 속도 제한 페이지에 있습니다.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

키는 그 자체로 입력됩니다. Bearer 접두사가 없으며, 다른 스킴 단어도 없습니다. 발급된 그대로 키를 붙여넣으세요. 거의 모든 다른 API는 반대를 요구하므로, 작동하는 키가 고장난 것처럼 보이는 가장 흔한 이유입니다.

알아둘 만한 두 가지:

• 읽을 수 없는 키는 오류를 발생시키지 않습니다. 데이터 엔드포인트는 읽을 수 없는 키를 무시하고 일반적인 200 및 실제 데이터로 익명 호출자로 서비스하므로, 오타는 정확히 성공처럼 보입니다. 키를 설정한 후 어시스턴트에게 getKeyStatus을 실행하도록 요청하세요: API가 실제로 보는 플랜을 보고하고 키가 적용되지 않을 때 가능한 원인을 알려줍니다.
• Pro 고객은 추가로 DEXPAPRIKA_API_BASE_URL을 https://api-pro.dexpaprika.com로 설정합니다. 호스트는 자동으로 변경되지 않습니다. 해당 호스트에 무료 키를 보내면 403이 반환되기 때문입니다.

호스팅 서버 (설치 불필요)

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

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

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

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

사용 가능한 도구 (17)

이 자체 호스팅 빌드는 17개의 읽기 도구를 등록합니다: 16개의 시장 데이터 도구와 getKeyStatus입니다. mcp.dexpaprika.com의 호스팅 서버는 submitFeedback을 포함한 자체 세트를 등록합니다. 실제 tools/list로 확인하세요.

검색

도구	설명
getCapabilities	서버 기능, 워크플로 패턴, 네트워크 동의어, 모범 사례. 여기서 시작하세요.
getNetworks	지원되는 모든 블록체인 네트워크 나열 (36)
getStats	상위 수준 생태계 통계 (총 네트워크, DEX, 풀, 토큰 수)
search	이름, 심볼 또는 주소로 모든 네트워크에서 토큰, 풀, DEX 검색
getKeyStatus	키가 전송되고 있는지와 API가 보는 플랜을 확인. 시장 데이터를 읽지 않음.

DEX 작업

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

풀 작업

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

토큰 작업

도구	설명	필수 매개변수
getTokenDetails	상세 토큰 정보	network, token_address
getTokenPools	토큰을 포함하는 유동성 풀 (네트워크 범위 필터, results + 커서 페이지네이션)	network, token_address
getTokenMultiPrices	최대 10개 토큰의 일괄 가격	network, tokens[]
getTopTokens	거래량, 유동성, FDV 또는 24시간 가격 변동 기준으로 순위가 매겨진 네트워크의 상위 토큰	network
filterNetworkTokens	거래량, 유동성, FDV, 거래 수, 생성 시간으로 토큰 필터링	network

사용 예시

// 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 pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  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_usd_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 풀 최근 거래를 가져와 매수 vs 매도 압력을 분석하세요."
• "이더리움에서 24시간 거래량 기준 상위 10개 풀을 보여주세요."
• "ARB 토큰을 포함하는 모든 풀을 검색하고 거래량 순으로 정렬하세요."
• "지난주에 생성된 24시간 거래량 $100K 이상의 이더리움 풀을 필터링하세요."
• "먼저 사용 가능한 모든 네트워크를 가져온 다음 각 주요 네트워크의 상위 풀을 보여주세요."

속도 제한 및 성능

• 무료 티어: 키 없이, 가입 없이 분당 30회 요청. 무료 API 키는 월별 할당량을 높이고 스트리밍을 잠금 해제합니다. Pro는 월 $99로 분당 300회 요청. 요청 1회는 크레딧 1개를 소비하며, 일괄 엔드포인트는 항목당 크레딧 1개를 소비합니다. 월별 할당량은 변경되므로 이 페이지가 아닌 여기에서 확인하세요: https://dexpaprika.com/api/pricing
• 데이터 지연: 무료 티어는 최대 15초, Pro는 실시간
• 응답 시간: 대부분의 엔드포인트에서 100-500ms (네트워크에 따라 다름)
• 오류 처리: 코드, 제안, 재시도 안내가 포함된 구조화된 오류
• 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 서버, 설정 불필요 옵션
• Model Context Protocol 사양
• DexPaprika - 종합 온체인 분석 시장 데이터
• CoinPaprika - 종합 암호화폐 시장 데이터