DexPaprika

DexPaprika MCP Server

DexPaprikaの暗号通貨およびDEXデータAPIへのオンデマンドアクセスを提供するModel Context Protocol (MCP)サーバーです。ClaudeのようなAIアシスタントが、設定不要で現在のトークン、プール、DEXデータをプログラム的に取得できるように構築されています。

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCPは、複数のブロックチェーンにわたるライブDEXデータにClaudeを接続します。無料ティアは開始に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キーの使用

これはキーなしで動作し、今後も常に動作します。 サインアップ不要、カード不要、設定するものは何もありません。上記のすべてがサポートされている実行方法です。

無料キーは月間割り当てを引き上げ、公開ショーケースセットではなく任意のトークンでストリーミングを有効にします。1分あたりのリクエスト制限は引き上げられません。これは両ティアで同じです。console.dexpaprika.com で取得できます。現在の制限はレート制限ページにあります。

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

キーは単独で設定されます。Bearer プレフィックスはありません、他のスキームワードもありません。発行されたキーをそのまま貼り付けてください。ほとんどすべての他のAPIは逆を要求するため、これは正常なキーが壊れて見える最も一般的な理由です。

知っておくべき2つのこと:

• 読み取れないキーはエラーを生成しません。 データエンドポイントは読み取れないキーを無視し、通常の 200 と実際のデータで匿名呼び出し元としてサービスを提供するため、タイプミスは成功とまったく同じに見えます。設定後に getKeyStatus を実行するようアシスタントに依頼してください: APIが実際に認識するプランを報告し、キーが届いていない場合の考えられる原因を特定します。
• Pro顧客はさらに DEXPAPRIKA_API_BASE_URL を https://api-pro.dexpaprika.com に設定します。無料キーをそのホストに送信すると403が返るため、ホストは自動的に変更されません。

ホステッドサーバー(インストール不要)

ゼロセットアップを希望する場合は、任意のMCP互換クライアントを mcp.dexpaprika.com のホステッドサーバーに直接向けてください。ランディングページにはセットアップ手順とドキュメントが用意されています。以下のトランスポートエンドポイントが利用可能です:

トランスポート	エンドポイント	ユースケース
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	名前、シンボル、またはアドレスでALLネットワークにわたってトークン、プール、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用のサンプルプロンプト

• "SolanaのJUPトークンを分析してください。価格、出来高、上位流動性プールを取得してください。"
• "Ethereum上のUniswap V3とSushiSwapの取引量を比較してください。"
• "RaydiumのSOL/USDCの7日間OHLCVデータを取得し、価格チャートをプロットしてください。"
• "Fantomネットワークで流動性上位5プールを見つけ、その手数料体系を分析してください。"
• "UniswapのETH/USDTプールの最近の取引を取得し、買い圧力と売り圧力を分析してください。"
• "Ethereumの24時間出来高上位10プールを表示してください。"
• "ARBトークンを含むすべてのプールを検索し、出来高でランク付けしてください。"
• "先週作成された24時間出来高が10万ドルを超えるEthereumプールをフィルタリングしてください。"
• "まず利用可能なすべてのネットワークを取得し、次に各主要ネットワークの上位プールを表示してください。"

レート制限とパフォーマンス

• 無料ティア: キー不要、サインアップ不要、毎分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 - 包括的な暗号通貨マーケットデータ