DexPaprika

Máy chủ MCP DexPaprika

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) cung cấp quyền truy cập theo yêu cầu vào API dữ liệu tiền điện tử và DEX của DexPaprika. Được xây dựng đặc biệt cho các trợ lý AI như Claude để tìm nạp dữ liệu token, pool và DEX hiện tại theo chương trình mà không cần cấu hình.

Tóm tắt nhanh

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP kết nối Claude với dữ liệu DEX trực tiếp trên nhiều blockchain. Gói miễn phí không cần khóa API để bắt đầu. Cài đặt | Cấu hình | Tài liệu tham khảo API

Thích thiết lập bằng không? Sử dụng máy chủ MCP được lưu trữ tại mcp.dexpaprika.com: không cần cài đặt, không cần khóa để bắt đầu, các công cụ dữ liệu tương tự cộng với submitFeedback. Xem Máy chủ được lưu trữ để biết các điểm cuối truyền tải.

Bản phát hành mới nhất

Xem CHANGELOG.md để biết ghi chú phát hành và hướng dẫn di chuyển.

Bạn Có Thể Xây Dựng Gì?

• Công cụ Phân tích Token: Theo dõi biến động giá, thay đổi độ sâu thanh khoản và mô hình khối lượng
• So sánh DEX: Phân tích cấu trúc phí, khối lượng và các pool khả dụng trên các DEX khác nhau
• Phân tích Pool Thanh khoản: Giám sát thay đổi TVL, tính toán tổn thất tạm thời và đánh giá tác động giá
• Phân tích Thị trường: So sánh token xuyên chuỗi, xu hướng khối lượng và số liệu hoạt động giao dịch
• Trình theo dõi Danh mục đầu tư: Theo dõi giá trị hiện tại, phân tích hiệu suất lịch sử, cơ hội lợi suất
• Phân tích Kỹ thuật: Thực hiện phân tích kỹ thuật nâng cao bằng dữ liệu OHLCV lịch sử, bao gồm xác định xu hướng, nhận dạng mẫu hình và tính toán chỉ báo

Cài đặt

Cài đặt qua Smithery

Để cài đặt DexPaprika cho Claude Desktop tự động qua Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Cài đặt Thủ công

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

# Start the server
dexpaprika-mcp

Đây là máy chủ stdio: nó nói MCP qua stdin và stdout và không ràng buộc cổng. Khi khởi động, nó ghi DexPaprika MCP server v<version> (tool contract v<contract>) is running... vào stderr và sau đó chờ máy khách. Chạy nó từ máy khách MCP (Claude Desktop, Cursor, Claude Code) thay vì mong đợi một URL trong trình duyệt.

Video Hướng dẫn

Xem hướng dẫn từng bước của chúng tôi về cách thiết lập và sử dụng máy chủ MCP DexPaprika:

Tích hợp Claude Desktop

Thêm nội dung sau vào tệp cấu hình Claude Desktop của bạn:

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

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

Sau khi khởi động lại Claude Desktop, các công cụ DexPaprika sẽ tự động có sẵn cho Claude.

Tùy chọn: sử dụng khóa API

Điều này hoạt động mà không cần khóa và sẽ luôn như vậy. Không cần đăng ký, không cần thẻ, không cần cấu hình gì cả. Mọi thứ ở trên là cách được hỗ trợ để chạy nó.

Khóa miễn phí tăng hạn mức hàng tháng và mở phát trực tuyến trên bất kỳ token nào thay vì bộ trưng bày công khai. Nó không tăng giới hạn yêu cầu mỗi phút, giống nhau trên cả hai gói. Nhận một khóa tại console.dexpaprika.com; giới hạn hiện tại nằm trên trang giới hạn tốc độ.

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

Khóa tự nó đi vào. Không có tiền tố Bearer, và cũng không có từ lược đồ nào khác. Dán khóa chính xác như được cấp. Hầu hết mọi API khác đều muốn điều ngược lại, vì vậy đây là lý do phổ biến nhất khiến một khóa hoạt động trông có vẻ bị hỏng.

Hai điều đáng biết:

• Một khóa chúng tôi không thể đọc không tạo ra lỗi. Các điểm cuối dữ liệu bỏ qua khóa không đọc được và phục vụ bạn như một người gọi ẩn danh, với 200 bình thường và dữ liệu thực, vì vậy lỗi chính tả trông giống hệt thành công. Yêu cầu trợ lý chạy getKeyStatus sau khi đặt một khóa: nó báo cáo gói mà API thực sự thấy và nêu tên nguyên nhân có khả năng khi khóa không đến.
• Khách hàng Pro cũng đặt DEXPAPRIKA_API_BASE_URL thành https://api-pro.dexpaprika.com. Máy chủ không tự động thay đổi, vì gửi khóa miễn phí đến máy chủ đó trả về 403.

Máy chủ được lưu trữ (không cần cài đặt)

Nếu bạn thích thiết lập bằng không, hãy trỏ bất kỳ máy khách tương thích MCP nào trực tiếp đến máy chủ được lưu trữ tại mcp.dexpaprika.com. Trang đích cung cấp hướng dẫn thiết lập và tài liệu. Các điểm cuối truyền tải sau có sẵn:

Truyền tải	Điểm cuối	Trường hợp sử dụng
HTTP có thể phát trực tuyến	https://mcp.dexpaprika.com/streamable-http	Được khuyến nghị cho hầu hết máy khách
SSE	https://mcp.dexpaprika.com/sse	Truyền tải SSE kế thừa
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC trực tiếp

Lưu ý: Đây là các điểm cuối giao thức MCP. Chúng sẽ không hiển thị bất cứ điều gì trong trình duyệt. Truy cập mcp.dexpaprika.com để xem trang đích.

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

Các Công cụ Khả dụng (17)

Bản dựng tự lưu trữ này đăng ký 17 công cụ đọc: 16 công cụ dữ liệu thị trường cộng với getKeyStatus. Máy chủ được lưu trữ tại mcp.dexpaprika.com đăng ký bộ công cụ riêng bao gồm submitFeedback. Xác minh một trong hai bằng tools/list trực tiếp.

Khám phá

Công cụ	Mô tả
getCapabilities	Khả năng máy chủ, mẫu quy trình làm việc, từ đồng nghĩa mạng và thực tiễn tốt nhất. Bắt đầu ở đây.
getNetworks	Liệt kê mọi mạng blockchain được hỗ trợ (36)
getStats	Thống kê hệ sinh thái cấp cao (tổng mạng, DEX, pool, token)
search	Tìm kiếm token, pool và DEX trên TẤT CẢ các mạng theo tên, ký hiệu hoặc địa chỉ
getKeyStatus	Liệu khóa có đang được gửi và gói nào API thấy. Không đọc dữ liệu thị trường.

Hoạt động DEX

Công cụ	Mô tả	Tham số Bắt buộc
getNetworkDexes	Liệt kê DEX trên một mạng cụ thể	network

Hoạt động Pool

Công cụ	Mô tả	Tham số Bắt buộc
getNetworkPools	CHÍNH. Nhận các pool thanh khoản hàng đầu trên một mạng	network
getDexPools	Nhận các pool từ một DEX cụ thể (các hàng dưới results, phân trang con trỏ)	network, dex
getNetworkPoolsFilter	Lọc các pool theo khối lượng, giao dịch, thời gian tạo	network
getPoolDetails	Thông tin pool chi tiết (giá, khối lượng, TVL, token)	network, pool_address
getPoolOHLCV	Dữ liệu nến OHLCV lịch sử	network, pool_address, start
getPoolTransactions	Giao dịch/giao dịch mua bán gần đây cho một pool	network, pool_address

Hoạt động Token

Công cụ	Mô tả	Tham số Bắt buộc
getTokenDetails	Thông tin token chi tiết	network, token_address
getTokenPools	Các pool thanh khoản chứa một token (bộ lọc theo phạm vi mạng, results + phân trang con trỏ)	network, token_address
getTokenMultiPrices	Giá theo lô cho tối đa 10 token	network, tokens[]
getTopTokens	Các token hàng đầu trên một mạng được xếp hạng theo khối lượng, thanh khoản, FDV hoặc thay đổi giá 24h	network
filterNetworkTokens	Lọc token theo khối lượng, thanh khoản, FDV, giao dịch và thời gian tạo	network

Ví dụ Sử dụng

// 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: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

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

Mẫu Lời nhắc cho Claude

• "Phân tích token JUP trên Solana. Tìm nạp giá, khối lượng và các pool thanh khoản hàng đầu."
• "So sánh khối lượng giao dịch giữa Uniswap V3 và SushiSwap trên Ethereum."
• "Nhận OHLCV hàng giờ cho ngày cuối cùng cho SOL/USDC trên Raydium và vẽ biểu đồ giá."
• "Tìm 5 pool hàng đầu theo thanh khoản trên mạng Fantom và phân tích cấu trúc phí của chúng."
• "Nhận các giao dịch gần đây cho pool ETH/USDT trên Uniswap và phân tích áp lực mua so với bán."
• "Hiển thị cho tôi 10 pool hàng đầu trên Ethereum theo khối lượng 24h."
• "Tìm kiếm tất cả các pool chứa token ARB và xếp hạng chúng theo khối lượng."
• "Lọc các pool Ethereum có khối lượng 24h >100K$ được tạo trong tuần qua."
• "Đầu tiên nhận tất cả các mạng khả dụng, sau đó hiển thị cho tôi các pool hàng đầu trên mỗi mạng chính."

Giới hạn Tốc độ & Hiệu suất

• Gói miễn phí: không cần khóa, không cần đăng ký, ở mức 15 yêu cầu mỗi phút. Khóa API miễn phí tăng lên 30 yêu cầu mỗi phút, tăng hạn mức hàng tháng và mở khóa phát trực tuyến: đăng ký tại https://console.dexpaprika.com. Pro là $99/tháng ở mức 500 yêu cầu mỗi phút, và có gói Dev $30 ở mức 120. Một yêu cầu tốn một tín dụng; các điểm cuối theo lô tốn một tín dụng cho mỗi mục. Tài liệu đầy đủ tại https://docs.dexpaprika.com. Hạn mức hàng tháng thay đổi, vì vậy hãy đọc chúng ở đây thay vì từ trang này: https://dexpaprika.com/api/pricing
• Độ trễ dữ liệu: lên đến 60 giây trên gói miễn phí, thời gian thực trên các gói trả phí
• Thời gian phản hồi: 100-500ms cho hầu hết các điểm cuối (phụ thuộc mạng)
• Xử lý lỗi: Lỗi có cấu trúc với mã, gợi ý và hướng dẫn thử lại
• Khả dụng Dữ liệu OHLCV: Dữ liệu lịch sử thường có sẵn từ ngày tạo token/pool

Xử lý sự cố

Các vấn đề phổ biến:

• Giới hạn tốc độ: Nếu nhận lỗi DP429_RATE_LIMIT, hãy triển khai backoff theo cấp số nhân
• Thiếu dữ liệu: Một số token/pool mới hơn có thể có dữ liệu lịch sử không đầy đủ
• Lỗi hết thời gian: Các yêu cầu dữ liệu lớn có thể mất nhiều thời gian hơn, hãy xem xét phân trang
• Lỗi mạng: Kiểm tra kết nối mạng, dịch vụ yêu cầu truy cập internet
• Hạn chế OHLCV: Một yêu cầu trả về tối đa 1000 nến (limit); cho khoảng thời gian dài hơn, di chuyển start về phía trước và hỏi lại. Không có khóa, OHLCV bao phủ 24 giờ qua tại 1h và lâu hơn (start: "-24h"); khóa miễn phí mở 7 ngày tại 10m và lâu hơn. Xem Giới hạn OHLCV theo gói
• OHLCV trống: Pool có thể quá mới. Sử dụng getPoolTransactions thay thế

Phát triển

# 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

Nhật ký thay đổi

Xem CHANGELOG.md để biết ghi chú phát hành chi tiết và hướng dẫn di chuyển.

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem tệp LICENSE để biết chi tiết.

Tài nguyên Bổ sung

• Tài liệu API DexPaprika
• Máy chủ MCP được lưu trữ, tùy chọn thiết lập bằng không
• Đặc tả Giao thức Ngữ cảnh Mô hình
• DexPaprika - Dữ liệu thị trường phân tích onchain toàn diện
• CoinPaprika - Dữ liệu thị trường tiền điện tử toàn diện